设计dapm的主要目的之一，就是希望声卡上的各种部件的电源按需分配，需要的就上电，不需要的就下电，使得整个音频系统总是处于最小的耗电状态，最主要的就是，这一切对用户空间的应用程序是透明的，也就是说，用户空间的应用程序无需关心那个部件何时需要电源，它只要按需要设定好音频路径，播放音频数据，暂停或停止，dapm框架会根据音频路径，完美地对各种部件的电源进行控制，而且精确地按某种顺序进行，防止上下电过程中产生不必要的pop-pop声。这就是本章我们需要讨论的内容。

/*****************************************************************************************************/
声明：本博内容均由http://blog.csdn.net/droidphone原创，转载请注明出处，谢谢！
/*****************************************************************************************************/

统计widget连接至端点widget的路径个数

ALSA声卡驱动中的DAPM详解之四：在驱动程序中初始化并注册widget和route这篇文章中的最后一节，我们曾经提出了端点widget这一概念，端点widget位于音频路径的起始端或者末端，所以通常它们就是指codec的输入输出引脚所对应的widget，或者是外部器件对应的widget，这些widget的类型有以下这些：

 

端点widget的种类
分类 widget类型
codec的输入输出引脚 snd_soc_dapm_output
snd_soc_dapm_input
外接的音频设备 snd_soc_dapm_hp
snd_soc_dapm_spk
snd_soc_dapm_line
snd_soc_dapm_mic
音频流（stream domain） snd_soc_dapm_adc
snd_soc_dapm_dac
snd_soc_dapm_aif_out
snd_soc_dapm_aif_in
snd_soc_dapm_dai_out
snd_soc_dapm_dai_in
电源、时钟 snd_soc_dapm_supply
snd_soc_dapm_regulator_supply
snd_soc_dapm_clock_supply
影子widget snd_soc_dapm_kcontrol

dapm要给一个widget上电的其中一个前提条件是：这个widget位于一条完整的音频路径上，而一条完整的音频路径的两头，必须是输入/输出引脚，或者是一个外部音频设备，又或者是一个处于激活状态的音频流widget，也就是上表中的前三项，上表中的后两项，它们可以位于路径的末端，但不是构成完成音频路径的必要条件，我们只用它来判断扫描一条路径的结束条件。dapm提供了两个内部函数，用来统计一个widget连接到输出引脚、输入引脚、激活的音频流widget的有效路径个数：

 

 

  • is_connected_output_ep    返回连接至输出引脚或激活状态的输出音频流的路径数量
  • is_connected_input_ep    返回连接至输入引脚或激活状态的输入音频流的路径数量

下面我贴出is_connected_output_ep函数和必要的注释：

 

[html] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. static int is_connected_output_ep(struct snd_soc_dapm_widget *widget,  
  2.         struct snd_soc_dapm_widget_list **list)  
  3. {  
  4.         struct snd_soc_dapm_path *path;  
  5.         int con = 0;  
  6.         /*  多个路径可能使用了同一个widget，如果在遍历另一个路径时，*/  
  7.         /*  已经统计过该widget，直接返回output字段即可。            */  
  8.         if (widget->outputs >= 0)  
  9.                 return widget->outputs;  
  10.   
  11.         /*  以下这几种widget是端点widget，但不是输出，所以直接返回0，结束该路径的扫描  */  
  12.         switch (widget->id) {  
  13.         case snd_soc_dapm_supply:  
  14.         case snd_soc_dapm_regulator_supply:  
  15.         case snd_soc_dapm_clock_supply:  
  16.         case snd_soc_dapm_kcontrol:  
  17.                 return 0;  
  18.         default:  
  19.                 break;  
  20.         }  
  21.         /*  对于音频流widget，如果处于激活状态，如果没有休眠，返回1，否则，返回0  */  
  22.         /*  而且对于激活的音频流widget是端点widget，所以也会结束该路径的扫描  */  
  23.         /*  如果没有处于激活状态，按普通的widget继续往下执行  */  
  24.         switch (widget->id) {  
  25.         case snd_soc_dapm_adc:  
  26.         case snd_soc_dapm_aif_out:  
  27.         case snd_soc_dapm_dai_out:  
  28.                 if (widget->active) {  
  29.                         widget->outputs = snd_soc_dapm_suspend_check(widget);  
  30.                         return widget->outputs;  
  31.                 }  
  32.         default:  
  33.                 break;  
  34.         }  
  35.   
  36.         if (widget->connected) {  
  37.                 /* 处于连接状态的输出引脚，也根据休眠状态返回1或0 */  
  38.                 if (widget->id == snd_soc_dapm_output && !widget->ext) {  
  39.                         widget->outputs = snd_soc_dapm_suspend_check(widget);  
  40.                         return widget->outputs;  
  41.                 }  
  42.   
  43.                 /* 处于连接状态的输出设备，也根据休眠状态返回1或0 */  
  44.                 if (widget->id == snd_soc_dapm_hp ||  
  45.                     widget->id == snd_soc_dapm_spk ||  
  46.                     (widget->id == snd_soc_dapm_line &&  
  47.                      !list_empty(&widget->sources))) {  
  48.                         widget->outputs = snd_soc_dapm_suspend_check(widget);  
  49.                         return widget->outputs;  
  50.                 }  
  51.         }  
  52.         /*  不是端点widget，循环查询它的输出端  */  
  53.         list_for_each_entry(path, &widget->sinks, list_source) {  
  54.                 DAPM_UPDATE_STAT(widget, neighbour_checks);  
  55.   
  56.                 if (path->weak)  
  57.                         continue;  
  58.   
  59.                 if (path->walking)   /* 比较奇怪，防止无限循环的路径？ */  
  60.                         return 1;  
  61.   
  62.                 if (path->walked)  
  63.                         continue;  
  64.   
  65.                 if (path->sink && path->connect) {  
  66.                         path->walked = 1;  
  67.                         path->walking = 1;  
  68.                         ……  
  69.                         /*  递归调用，统计每一个输出端  */  
  70.                         con += is_connected_output_ep(path->sink, list);  
  71.   
  72.                         path->walking = 0;  
  73.                 }  
  74.         }  
  75.   
  76.         widget->outputs = con;  
  77.   
  78.         return con;  
  79. }  

该函数使用了递归算法，直到遇到端点widget为止才停止扫描，把统计到的输出路径个数保存在output字段中并返回。is_connected_intput_ep函数的原理差不多，有兴趣的苏浙可以自己查看内核的原码。

 

dapm_dirty链表

在代表声卡的snd_soc_card结构中，有一个链表字段：dapm_dirty，所有状态发生了改变的widget，dapm不会立刻处理它的电源状态，而是需要先挂在该链表下面，等待后续的进一步处理：或者是上电，或者是下电。dapm为我们提供了一个api函数来完成这个动作：

 

[html] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. void dapm_mark_dirty(struct snd_soc_dapm_widget *w, const char *reason)  
  2. {  
  3.         if (!dapm_dirty_widget(w)) {  
  4.                 dev_vdbg(w->dapm->dev, “Marking %s dirty due to %s\n”,  
  5.                          w->name, reason);  
  6.                 list_add_tail(&w->dirty, &w->dapm->card->dapm_dirty);  
  7.         }  
  8. }  

 

power_check回调函数

在文章 ALSA声卡驱动中的DAPM详解之五：建立widget之间的连接关系中，我们知道，在创建widget的时候，widget的power_check回调函数会根据widget的类型，设置不同的回调函数。当widget的状态改变后，dapm会遍历dapm_dirty链表，并通过power_check回调函数，决定该widget是否需要上电。大多数的widget的power_check回调被设置为：dapm_generic_check_power：

 

[html] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. static int dapm_generic_check_power(struct snd_soc_dapm_widget *w)  
  2. {  
  3.         int in, out;  
  4.   
  5.         DAPM_UPDATE_STAT(w, power_checks);  
  6.   
  7.         in = is_connected_input_ep(w, NULL);  
  8.         dapm_clear_walk_input(w->dapm, &w->sources);  
  9.         out = is_connected_output_ep(w, NULL);  
  10.         dapm_clear_walk_output(w->dapm, &w->sinks);  
  11.         return out != 0 && in != 0;  
  12. }  

很简单，分别用is_connected_output_ep和is_connected_input_ep得到该widget是否有同时连接到一个输入端和一个输出端，如果是，返回1来表示该widget需要上电。

 

对于snd_soc_dapm_dai_out和snd_soc_dapm_dai_in类型，power_check回调是dapm_adc_check_power和dapm_dac_check_power，这里以dapm_dac_check_power为例：

 

[html] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. static int dapm_dac_check_power(struct snd_soc_dapm_widget *w)  
  2. {  
  3.         int out;  
  4.   
  5.         DAPM_UPDATE_STAT(w, power_checks);  
  6.   
  7.         if (w->active) {  
  8.                 out = is_connected_output_ep(w, NULL);  
  9.                 dapm_clear_walk_output(w->dapm, &w->sinks);  
  10.                 return out != 0;  
  11.         } else {  
  12.                 return dapm_generic_check_power(w);  
  13.         }  
  14. }  

处于激活状态时，只判断是否有连接到有效的输出路径即可，没有激活时，则需要同时判断是否有连接到输入路径和输出路径。

 

widget的上电和下电顺序

在扫描dapm_dirty链表时，dapm使用两个链表来分别保存需要上电和需要下电的widget：

 

  • up_list           保存需要上电的widget
  • down_list     保存需要下电的widget

 

dapm内部使用dapm_seq_insert函数把一个widget加入到上述两个链表中的其中一个：

 

[cpp] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. static void dapm_seq_insert(struct snd_soc_dapm_widget *new_widget,  
  2.                             struct list_head *list,  
  3.                             bool power_up)  
  4. {  
  5.         struct snd_soc_dapm_widget *w;  
  6.   
  7.         list_for_each_entry(w, list, power_list)  
  8.                 if (dapm_seq_compare(new_widget, w, power_up) < 0) {  
  9.                         list_add_tail(&new_widget->power_list, &w->power_list);  
  10.                         return;  
  11.                 }  
  12.   
  13.         list_add_tail(&new_widget->power_list, list);  
  14. }  

上述函数会按照一定的顺序把widget加入到链表中，从而保证正确的上下电顺序：

 

 

        上电顺序         下电顺序
static int dapm_up_seq[] = {
        [snd_soc_dapm_pre] = 0,
        [snd_soc_dapm_supply] = 1,
        [snd_soc_dapm_regulator_supply] = 1,
        [snd_soc_dapm_clock_supply] = 1,
        [snd_soc_dapm_micbias] = 2,
        [snd_soc_dapm_dai_link] = 2,
        [snd_soc_dapm_dai_in] = 3,
        [snd_soc_dapm_dai_out] = 3,
        [snd_soc_dapm_aif_in] = 3,
        [snd_soc_dapm_aif_out] = 3,
        [snd_soc_dapm_mic] = 4,
        [snd_soc_dapm_mux] = 5,
        [snd_soc_dapm_virt_mux] = 5,
        [snd_soc_dapm_value_mux] = 5,
        [snd_soc_dapm_dac] = 6,
        [snd_soc_dapm_switch] = 7,
        [snd_soc_dapm_mixer] = 7,
        [snd_soc_dapm_mixer_named_ctl] = 7,
        [snd_soc_dapm_pga] = 8,
        [snd_soc_dapm_adc] = 9,
        [snd_soc_dapm_out_drv] = 10,
        [snd_soc_dapm_hp] = 10,
        [snd_soc_dapm_spk] = 10,
        [snd_soc_dapm_line] = 10,
        [snd_soc_dapm_kcontrol] = 11,
        [snd_soc_dapm_post] = 12,
};		 static int dapm_down_seq[] = {
        [snd_soc_dapm_pre] = 0,
        [snd_soc_dapm_kcontrol] = 1,
        [snd_soc_dapm_adc] = 2,
        [snd_soc_dapm_hp] = 3,
        [snd_soc_dapm_spk] = 3,
        [snd_soc_dapm_line] = 3,
        [snd_soc_dapm_out_drv] = 3,
        [snd_soc_dapm_pga] = 4,
        [snd_soc_dapm_switch] = 5,
        [snd_soc_dapm_mixer_named_ctl] = 5,
        [snd_soc_dapm_mixer] = 5,
        [snd_soc_dapm_dac] = 6,
        [snd_soc_dapm_mic] = 7,
        [snd_soc_dapm_micbias] = 8,
        [snd_soc_dapm_mux] = 9,
        [snd_soc_dapm_virt_mux] = 9,
        [snd_soc_dapm_value_mux] = 9,
        [snd_soc_dapm_aif_in] = 10,
        [snd_soc_dapm_aif_out] = 10,
        [snd_soc_dapm_dai_in] = 10,
        [snd_soc_dapm_dai_out] = 10,
        [snd_soc_dapm_dai_link] = 11,
        [snd_soc_dapm_clock_supply] = 12,
        [snd_soc_dapm_regulator_supply] = 12,
        [snd_soc_dapm_supply] = 12,
        [snd_soc_dapm_post] = 13,
};

 

widget的上下电过程

dapm_power_widgets

当一个widget的状态改变后，该widget会被加入dapm_dirty链表，然后通过dapm_power_widgets函数来改变整个音频路径上的电源状态，下图展现了这个函数的调用过程：

                                                  图1    widget的上电过程

 

  • 可见，该函数通过遍历dapm_dirty链表，对每个链表中的widget调用dapm_power_one_widget，dapm_power_one_widget函数除了处理自身的状态改变外，还把自身的变化传递到和它相连的邻居widget中，结果就是，所有需要上电的widget会被放在up_list链表中，而所有需要下电的widget会被放在down_list链表中，这个函数我们稍后再讨论。
  • 遍历down_list链表，向其中的widget发出SND_SOC_DAPM_WILL_PMD事件，感兴趣该事件的widget的event回调会被调用。
  • 遍历up_list链表，向其中的widget发出SND_SOC_DAPM_WILL_PMU事件，感兴趣该事件的widget的event回调会被调用。
  • 通过dapm_seq_run函数，处理down_list中的widget，使它们按定义好的顺序依次下电。
  • 通过dapm_widget_update函数，切换触发该次状态变化的widget的kcontrol中的寄存器值，对应的结果就是：改变音频路径。
  • 通过dapm_seq_run函数，处理up_list中的widget，使它们按定义好的顺序依次上电。
  • 对每个dapm context发出状态改变回调。
  • 适当的延时，防止pop-pop声。

 

dapm_power_one_widget

dapm_power_widgets的第一步，就是遍历dapm_dirty链表，对每个链表中的widget调用dapm_power_one_widget，把需要上电和需要下电的widget分别加入到up_list和down_list链表中，同时，他还会把受到影响的邻居widget再次加入到dapm_dirty链表的末尾，通过这个动作，声卡中所以受到影响的widget都会被“感染”，依次被加到dapm_dirty链表，然后依次被执行dapm_power_one_widget函数。下图展示了dapm_power_one_widget函数的调用序列：
                                                                           图二    dapm_power_one_widget函数调用过程
  • 通过dapm_widget_power_check，调用widget的power_check回调函数，获得该widget新的电源状态。
  • 调用dapm_widget_set_power，“感染”与之相连的邻居widget。
    • 遍历source widget，通过dapm_widget_set_peer_power函数，把处于连接状态的source widget加入dapm_dirty链表中。
    • 遍历sink widget，通过dapm_widget_set_peer_power函数，把处于连接状态的sink widget加入dapm_dirty链表中。
  • 根据第一步得到的新的电源状态，把widget加入到up_list或down_list链表中。

可见，通过该函数，一个widget的状态改变，邻居widget会受到“感染”而被加入到dapm_dirty链表的末尾，所以扫描到链表的末尾时，邻居widget也会执行同样的操作，从而“感染”邻居的邻居，直到没有新的widget被加入dapm_dirty链表为止，这时，所有受到影响的widget都被加入到up_list或down_li链表中，等待后续的上下电操作。这就是文章的标题所说的那样：牵一发而动全身。

dapm_seq_run

参看图一的上电过程，当所有需要上电或下电的widget都被加入到dapm_dirty链表后，接着会通过dapm_seq_run处理down_list链表上的widget，把该链表上的widget按顺序下电，然后通过dapm_widget_update更新widget中的kcontrol（这个kcontrol通常就是触发本次状态改变的触发源），接着又通过apm_seq_run处理up_list链表上的widget，把该链表上的widget按顺序上电。最终的上电或下电操作需要通过codec的寄存器来实现，因为定义widget时，如果这是一个带电源控制的widget，我们必须提供reg/shift等字段的设置值，如果该widget无需寄存器控制电源状态，则reg字段必须赋值为：
  • SND_SOC_NOPM        (该宏定义的实际值是-1)
具体实现上，dapm框架使用了一点技巧：如果位于同一个上下电顺序的几个widget使用了同一个寄存器地址（一个寄存器可能使用不同的位来控制不同的widget的电源状态），dapm_seq_run通过dapm_seq_run_coalesced函数合并这几个widget的变更，然后只需要把合并后的值一次写入寄存器即可。

dapm kcontrol的put回调

上面我们已经讨论了如何判断一个widget是否需要上电，以及widget的上电过程，一个widget的状态改变如何传递到整个音频路径上的所有widget。这些过程总是需要一个起始点：是谁触动了dapm，使得它需要执行上述的扫描和上电过程？事实上，以下几种情况可以触发dapm发起一次扫描操作：

 

  • 声卡初始化阶段，snd_soc_dapm_new_widgets函数创建widget包含的kcontrol后，会触发一次扫描操作。
  • 用户空间的应用程序修改了widget中包含的dapm kcontrol的配置值时，会触发一次扫描操作。
  • pcm的打开或关闭，会通过音频流widget触发一次扫描操作。
  • 驱动程序在改变了某个widget并把它加入到dapm_dirty链表后，主动调用snd_soc_dapm_sync函数触发扫描操作。
这里我们主要讨论一下第二种，用户空间对kcontrol的修改，最终都会调用到kcontrol的put回调函数。对于常用的dapm kcontrol，系统已经为我们定义好了它们的put回调函数：
  • snd_soc_dapm_put_volsw                                  mixer类型的dapm kcontrol使用的put回调
  • snd_soc_dapm_put_enum_double                   mux类型的dapm kcontrol使用的put回调
  • snd_soc_dapm_put_enum_virt                          虚拟mux类型的dapm kcontrol使用的put回调
  • snd_soc_dapm_put_value_enum_double      控制值不连续的mux类型的dapm kcontrol使用的put回调
  • snd_soc_dapm_put_pin_switch                         引脚类dapm kcontrol使用的put回调
我们以mixer类型的dapm kcontrol的put回调讲解一下触发的过程：
                                                                    图三    mixer dapm kcontrol的put回调
 
[cpp] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. int snd_soc_dapm_put_volsw(struct snd_kcontrol *kcontrol,  
  2.         struct snd_ctl_elem_value *ucontrol)  
  3. {  
  4.         struct snd_soc_codec *codec = snd_soc_dapm_kcontrol_codec(kcontrol);  
  5.         struct snd_soc_card *card = codec->card;  
  6.         struct soc_mixer_control *mc =  
  7.                 (struct soc_mixer_control *)kcontrol->private_value;  
  8.         unsigned int reg = mc->reg;  
  9.         unsigned int shift = mc->shift;  
  10.         int max = mc->max;  
  11.         unsigned int mask = (1 << fls(max)) – 1;  
  12.         unsigned int invert = mc->invert;  
  13.         unsigned int val;  
  14.         int connect, change;  
  15.         struct snd_soc_dapm_update update;  
  16.         ……  
  17.         /* 从参数中取出要设置的新的设置值 */  
  18.         val = (ucontrol->value.integer.value[0] & mask);  
  19.         connect = !!val;  
  20.   
  21.         if (invert)  
  22.                 val = max – val;  
  23.   
  24.         /* 把新的设置值缓存到kcontrol的影子widget中 */  
  25.         dapm_kcontrol_set_value(kcontrol, val);  
  26.   
  27.         mask = mask << shift;  
  28.         val = val << shift;  
  29.         /* 和实际寄存器中的值进行对比，不一样时才会触发寄存器的写入 */  
  30.         /* 寄存器通常都会通过regmap机制进行缓存，所以这个测试不会发生实际的寄存器读取操作 */  
  31.         /* 这里只是触发，真正的寄存器写入操作要在扫描完dapm_dirty链表后的执行 */  
  32.         change = snd_soc_test_bits(codec, reg, mask, val);  
  33.         if (change) {  
  34.                 update.kcontrol = kcontrol;  
  35.                 update.reg = reg;  
  36.                 update.mask = mask;  
  37.                 update.val = val;  
  38.   
  39.                 card->update = &update;  
  40.                 /* 触发dapm的上下电扫描过程 */  
  41.                 soc_dapm_mixer_update_power(card, kcontrol, connect);  
  42.   
  43.                 card->update = NULL;  
  44.         }  
  45.         ……  
  46.         return change;  
  47. }  

其中的dapm_kcontrol_set_value函数用于把设置值缓存到kcontrol对应的影子widget，影子widget是为了实现autodisable特性而创建的一个虚拟widget，影子widget的输出连接到kcontrol的source widget，影子widget的寄存器被设置为和kcontrol一样的寄存器地址，这样当source widget被关闭时，会触发影子widget被关闭，其作用就是kcontrol也被自动关闭从而在物理上断开与source widget的连接，但是此时逻辑连接依然有效，dapm依然认为它们是连接在一起的。 

触发dapm进行电源状态扫描关键的函数是soc_dapm_mixer_update_power：
[cpp] view plain copy

 

 在CODE上查看代码片派生到我的代码片

  1. static int soc_dapm_mixer_update_power(struct snd_soc_card *card,  
  2.                                    struct snd_kcontrol *kcontrol, int connect)  
  3. {  
  4.         struct snd_soc_dapm_path *path;  
  5.         int found = 0;  
  6.   
  7.         /* 更新所有和该kcontrol对应输入端相连的path的connect字段 */  
  8.         dapm_kcontrol_for_each_path(path, kcontrol) {  
  9.                 found = 1;  
  10.                 path->connect = connect;  
  11.                 /*把自己和相连的source widget加入到dirty链表中*/  
  12.                 dapm_mark_dirty(path->source, “mixer connection”);  
  13.                 dapm_mark_dirty(path->sink, “mixer update”);  
  14.         }  
  15.         /* 发起dapm_dirty链表扫描和上下电过程 */  
  16.         if (found)  
  17.                 dapm_power_widgets(card, SND_SOC_DAPM_STREAM_NOP);  
  18.   
  19.         return found;  
  20. }  

最终，还是通过dapm_power_widgets函数，触发整个音频路径的扫描过程，这个函数执行后，因为kcontrol的状态改变，被断开连接的音频路径上的所有widget被按顺序下电，而重新连上的音频路径上的所有widget被顺序地上电，所以，尽管我们只改变了mixer kcontrol中的一个输入端的连接状态，所有相关的widget的电源状态都会被重新设定，这一切，都是自动完成的，对用户空间的应用程序完全透明，实现了dapm的原本设计目标。

 

版权声明：本文为Ph-one原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://www.cnblogs.com/Ph-one/p/6297584.html