Android系统中从发生耳机插拔事件到音频Route切换过程分析

【概要】

    我们知道，耳机插入/拔出事件肯定是通过中断通知系统进行处理的。有了这个认识之后，我们就可以对这个过程进行逐个击破的分析了：

    1、  谁为耳机事件产生中断？

    2、  中断处理函数是哪个？

    3、  中断处理函数中执行了什么操作来改变音频Route？

 

【备注】

    本文基于我所使用的硬件环境进行分析，虽然可能与你现在使用的芯片不同，但思路是一样的。重在方法，不在结果。

 

 

【谁产生中断】

    要回答这个问题，需要查看耳机部分的电路原理图：

图1  耳机检测电路

    可以看到，耳机插口（headset-jack）是和ts3a227e这款耳机检测芯片相连接的。芯片上的/INT和/MIC_PRESENT应该就是中断输出引脚。查看芯片datasheet中的说明：

图2  ts3a227e芯片引脚说明

    至此我们就清楚了：当耳机插入/拔出时，ts3a227e能够检测到这一动作，同时向SoC发送中断。SoC接收到中断后，相应的中断处理函数会对硬件配置进行修改。

 

 

【找到中断处理函数】

    回忆一下《Linux设备驱动程序》这本书“中断处理”章节的内容：设备需要为自己要使用的中断线向系统申请中断号，并在系统中注册相应的中断处理函数。

    查看ts3a227e芯片的驱动源码文件ts3a227e.c可以发现该芯片是作为i2c设备进行注册的。在probe函数中不仅申请了设备中断号、绑定了中断处理函数ts3a227e_interrupt()，还向工作队列中添加了3个延迟任务，分别是hs_detect_func()、enable_key_detect_func()和long_press_func()，它们在后面很快就会被用到。如下所示：

static int ts3a227e_i2c_probe(struct i2c_client *i2c,
                                  const struct i2c_device_id *id)
{
         struct ts3a227e *ts3a227e;
         struct device *dev = &i2c->dev;
         unsigned int i;
         int ret;
         …...
         INIT_DELAYED_WORK(&ts3a227e->hs_det_work,hs_detect_func);
         INIT_DELAYED_WORK(&ts3a227e->enable_key_detect_work,enable_key_detect_func);
         INIT_DELAYED_WORK(&ts3a227e->long_press_work,long_press_func);
         if(i2c->irq != -1) {
                   ret = devm_request_threaded_irq(dev, i2c->irq, NULL, ts3a227e_interrupt,
                                                        IRQF_TRIGGER_LOW| IRQF_ONESHOT,
                                                        "TS3A227E",ts3a227e);
                   if(ret) {
                            dev_err(dev,"Cannot request irq %d (%d)\n", i2c->irq, ret);
                            return ret;
                   }
         }
         …...
         return 0;
}

 

【中断处理函数执行了什么操作】

    经过上面分析，我们可以判断当ts3a227e芯片发出的中断被SoC接收到时，函数ts3a227e_interrupt()会被立即调用。这个函数的功能有2个：读取寄存器以更新相关变量的值，以及调用之前添加到工作队列中的延迟任务hs_detect_func()。关键代码如下：

static irqreturn_t ts3a227e_interrupt(int irq, void *data)
{
         …...
         /* Check for plug/unplug. */
         regmap_read(regmap,TS3A227E_REG_INTERRUPT, &(ts3a227e->int_reg));
         pr_err("%sent, int_reg(0x01): %0x\n", __func__, ts3a227e->int_reg);
 
         if(ts3a227e->int_reg & (DETECTION_COMPLETE_EVENT | INS_REM_EVENT)) {
                   regmap_read(regmap,TS3A227E_REG_ACCESSORY_STATUS, &(ts3a227e->acc_reg));
                   pr_err("%sacc_reg(0x0b): %0x\n", __func__, ts3a227e->acc_reg);
         }
         …...
         cancel_delayed_work_sync(&ts3a227e->hs_det_work);
         schedule_delayed_work(&ts3a227e->hs_det_work,
                         msecs_to_jiffies(5));    /* 调度延迟任务hs_detect_func()*/
 
         return IRQ_HANDLED;
}

    被调用的hs_detect_func()函数代码如下：

static void hs_detect_func(struct work_struct *work)
{
         struct ts3a227e *ts3a227e = container_of(work,
                   structts3a227e, hs_det_work.work);
 
         pr_err("%s,id:%x\n", __func__, ts3a227e->id);
         check_jack_status(ts3a227e);
}

    被hs_detect_func()调用的check_jack_status()函数主要功能是：检测耳机是否完全插入/拔出，并完成耳机按键状态检测，最终调用ts3a227e_jack_report()函数根据检测结果上报用于执行音频Route切换的操作。关键代码如下：

static void check_jack_status(struct ts3a227e *ts3a227e)
{
         struct regmap *regmap = ts3a227e->regmap;
         unsigned int i;
         bool long_press_det = false;
 
         /* Check for plug/unplug. */
         if(ts3a227e->int_reg & (DETECTION_COMPLETE_EVENT | INS_REM_EVENT)) {
                   //regmap_read(regmap,TS3A227E_REG_ACCESSORY_STATUS, &acc_reg);
                   printk("%sacc_reg(0x0b): %0x\n", __func__, ts3a227e->acc_reg);
                   ts3a227e_new_jack_state(ts3a227e,ts3a227e->acc_reg);
         }
         …...
         input_sync(ts3a227e->button_dev);
         ts3a227e_jack_report(ts3a227e);
}

    分析到这里可以看到，紧接着在ts3a227e_jack_report()函数中要执行的就是操作硬件实现音频Route切换了。但为了看懂这个函数中的操作，我们需要先来看一看更宏观一点的电路关系，分别是耳机功放芯片电路和Codec芯片的部分电路：

图3  耳机功放芯片电路

图4  Codec芯片局部电路

    很明显，耳机功放芯片的片选引脚/SHDN连接到Codec芯片的GPIO5引脚上，由Codec芯片进行控制，低电平有效（就是说当/SHDN引脚上的电平为低时，耳机功放芯片将被关闭）。左右声道的音频信号分别从Codec芯片的LOUT1P、LOUT1N和LOUT2P、LOUT2N引脚输出到耳机功放芯片的INL+、INL-和INR+、INR-引脚上。

    所以如果想从耳机里听到声音，需要先将/SHDN引脚上的电平拉高。由于这个引脚上的电平是Codec芯片进行控制的，所以需要修改Codec芯片中的寄存器配置。

    我这里使用的Codec芯片为Realtek5677。

    电路分析到这里就可以继续阅读ts3a227e_jack_report()函数的实现细节了。它根据之前的耳机检测结果（是否插入耳机，插入的耳机是否带有麦克风），分别调用rt5677_enable_micbias()函数对Codec芯片Realtek5677进行相应配置。代码如下：

static void ts3a227e_jack_report(struct ts3a227e *ts3a227e)
{
         pr_err("%s\n",__func__);
 
         if(ts3a227e->plugged) {    /* 有耳机插入 */
                   pr_err("%s,HEADPHONE plug\n", __func__);
 
                   if(ts3a227e->mic_present) {    /* 插入的耳机带有麦克风 */
                            printk("%s,MICPHONE plug\n", __func__);
                            extcon_set_state(&ts3a227e->edev,BIT_HEADSET);
 
                            rt5677_enable_micbias(true);
                   }
                   else{    /* 插入的耳机不带麦克风 */
                            rt5677_enable_micbias(false);
                            extcon_set_state(&ts3a227e->edev,BIT_HEADSET_NO_MIC);
                   }
         }
         else{    /* 没有耳机插入 */
                   pr_err("%s,HEADSET unplug\n", __func__);
                   /*disable key press detection. */
       regmap_update_bits(ts3a227e->regmap, TS3A227E_REG_SETTING_2, KP_ENABLE,0);
                   extcon_set_state(&ts3a227e->edev,BIT_NO_HEADSET);
                   rt5677_enable_micbias(false);
         }
}

    再查看rt5677_enable_micbias()函数的实现细节，可以发现其使用了ASoC架构中的DAPM相关的函数。如下：

void rt5677_enable_micbias(bool enable)
{
         struct snd_soc_codec *codec;
 
         pr_err("%s,%d\n", __func__, enable);
         codec = cht_get_codec(&snd_soc_card_cht);   /* snd_soc_card_cht是个全局变量*/
         if(codec== NULL){
                   pr_err("%s,codec has not probed yet!\n", __func__);
                   return;
         }
         if(enable) {
                   snd_soc_dapm_force_enable_pin(&codec->dapm,"MICBIAS1");
         }
         else{
                   snd_soc_dapm_disable_pin(&codec->dapm,"MICBIAS1");
         }
         snd_soc_dapm_sync(&codec->dapm);
}

    这些DAPM函数经过一系列既定的调用流程后最终会落实到DAPM widgets上。关于DAPM的相关知识本篇文章不进行介绍（因为要写的话实在太多了），如果想了解这方面内容，我推荐你阅读Linux内核官方文档《Dynamic Audio Power Management for Portable Devices》、ALSA官方文档《DAPM》，或sepnic的博客，或我自己曾经也翻译过的一篇官方文档《DAPM概述（中文翻译）/ dapm.txt》。

    总之，最终要用到的DAPM widgets在ASoC Machine驱动的源文件cht_bl_dpcm_rt5677.c中进行了定义。Machine驱动中的声卡结构体定义如下：

/* SoC card */
static struct snd_soc_card snd_soc_card_cht= {
         .name= "cherrytrailaud",
         .dai_link= cht_dailink,
         .num_links= ARRAY_SIZE(cht_dailink),
         .set_bias_level= cht_set_bias_level,
         .dapm_widgets= cht_dapm_widgets,    /* DAPM widgets */
         .num_dapm_widgets= ARRAY_SIZE(cht_dapm_widgets),
         .dapm_routes= cht_audio_map,
         .num_dapm_routes= ARRAY_SIZE(cht_audio_map),
         .controls= cht_mc_controls,
         .num_controls= ARRAY_SIZE(cht_mc_controls),
};

    上述声卡所使用的DAPMwidgets定义如下，其中第一个对应的就是耳机插拔事件。其中cht_rt5677_hp_event()则是耳机插拔事件发生时要被执行的函数：

static const struct snd_soc_dapm_widgetcht_dapm_widgets[] = {
         SND_SOC_DAPM_HP("Headphone",cht_rt5677_hp_event),    /* 耳机事件的DAPMwidget */
         SND_SOC_DAPM_SPK("Speaker",cht_rt5677_spk_event),
         SND_SOC_DAPM_MIC("HeadsetMic", NULL),
         SND_SOC_DAPM_MIC("IntMic", NULL),
         SND_SOC_DAPM_SUPPLY("PlatformClock", SND_SOC_NOPM, 0, 0,
                            platform_clock_control,SND_SOC_DAPM_PRE_PMU|
                            SND_SOC_DAPM_POST_PMD),
};

    在cht_rt5677_hp_event()函数中就可以看到修改Codec芯片Realtek5677寄存器的相关代码了。通过拉高Codec芯片的GPIO5引脚上的电平，相应的耳机功放芯片上的/SHDN引脚电平也被拉高，耳机功放芯片开始工作。代码如下：

static int cht_rt5677_hp_event(structsnd_soc_dapm_widget *w,
                   struct snd_kcontrol *k, int  event)
{
         struct snd_soc_dapm_context *dapm = w->dapm;
         struct snd_soc_card *card = dapm->card;
         struct snd_soc_codec *codec;
 
         pr_err("%s,%d\n", __func__, __LINE__);
         codec = cht_get_codec(card);
         if(!codec) {
                   pr_err("Codecnot found; Unable to set platform clock\n");
                   return-EIO;
         }
         if(SND_SOC_DAPM_EVENT_ON(event)) {    /* 发生耳机插入事件 */
                   pr_err("%s,%d\n", __func__, __LINE__);
                   msleep(20);
                   snd_soc_update_bits(codec,RT5677_GPIO_CTRL2,
                            RT5677_GPIO5_OUT_MASK,RT5677_GPIO5_OUT_HI);    /* 将耳机功放芯片/SHDN引脚的电平拉高 */
                   msleep(50);
         }else {
                   pr_err("%s,%d\n", __func__, __LINE__);
                   snd_soc_update_bits(codec,RT5677_GPIO_CTRL2,
                            RT5677_GPIO5_OUT_MASK,RT5677_GPIO5_OUT_LO);
         }
 
         return 0;
}

    至此，从耳机插入/拔出到音频Route更改的过程就分析完毕了。希望这篇文章能让你有所收获。