Linux ASOC音频驱动架构分析

最新推荐文章于 2023-07-23 18:27:39 发布

若星裔_liu

最新推荐文章于 2023-07-23 18:27:39 发布

阅读量2.6k

点赞数

分类专栏： Linux内核学习文章标签： Linux 声卡驱动 ASOC架构 uda1341

Linux内核学习专栏收录该内容

0 篇文章 0 订阅

订阅专栏

Mini2440开发板

Kernel：linux 2.6.32.2

音频基于i2s总线接口（和l3总线接口对混音器进行设置）

Linux ASoC音频设备驱动

ASoC驱动的组成

ASoC（ALSA System on Chip）是ALSA在SoC方面的发展和演变，它在本质上仍然属于ALSA，但是在ALSA架构的基础上对CPU相关的代码和CODEC相关的代码进行了分离。其原因是，采用传统ALSA架构的情况下，同一型号的CODEC工作于不同的CPU时，需要不同的驱动，这不符合代码重用的要求。

ASoC主要由3部分组成。

（1）CODEC驱动。这一部分只关心CODEC本身，与CPU平台相关的特性不由此部分操作。

（2）平台驱动。这一部分只关心CPU本身，不关心CODEC。它主要处理两个问题：DMA引擎和SoC集成的PCM、I2S或AC’97数字接口的控制。

（3）板驱动。也称为machine驱动，这一部分将平台驱动和CODEC驱动绑定在一起，描述了板一级的硬件特征。

在以上3部分中，1和2基本上都可以仍然是通用的驱动了，也就是说，CODEC驱动认为自己可以连接任意CPU，而CPU的I2S、PCM、或AC’97接口对应的平台驱动则认为自己可以连接任意符合接口类型的CODEC，只有3是不通用的，由特性的电路板上具体的CPU和CODEC确定，因此它很像一个插座，上面插上了CODEC和平台这两个插头。

在以上三部分之上的是ASoC核心层，由内核源代码中的sound/soc/soc-core.c实现，查看其源代码发现它完全是一个传统的ALSA驱动。因此，对于基于ASoC架构的声卡驱动而言，alsa-lia以及ALSA的一系列utility仍然是可用的，如amixer、aplay均无需针对ASoC进行任何改动。而ASoC的用户编程方法也和ALSA完全一致。

内核源代码的Documentation/sound/slsa/soc目录包含了ASoC相关的文档。

1.ASoC CODEC驱动

在ASoC架构下，CODEC驱动负责如下工作：

（1）CODEC DAI（Digital Audio Interfaces）和配置PCM，由结构体snd_soc_dai来描述，形容playback、capture的属性以及DAI接口的操作。

位于内核源代码include/sound/soc-dai.h

/*
 * Digital Audio Interface runtime data.
 *
 * Holds runtime data for a DAI.
 */
struct snd_soc_dai {
        /* DAI description */      /*DAI的描述*/
        char *name;
        unsigned int id;
        int ac97_control;
 
        struct device *dev;
        void *ac97_pdata;  /* platform_data for the ac97 codec */ /*ac97平台数据*/
 
        /* DAI callbacks */
        int (*probe)(struct platform_device *pdev,
                      struct snd_soc_dai *dai);
        void (*remove)(struct platform_device *pdev,
                        struct snd_soc_dai *dai);
        int (*suspend)(struct snd_soc_dai *dai);
        int (*resume)(struct snd_soc_dai *dai);
 
        /* ops */
        struct snd_soc_dai_ops *ops;
 
        /* DAI capabilities */        /*DAI的能力*/
        struct snd_soc_pcm_stream capture;  /*录音*/
        struct snd_soc_pcm_stream playback;  /*放音*/
        unsigned int symmetric_rates:1;
 
        /* DAI runtime info */      /*DAI运行时的信息*/
        struct snd_pcm_runtime *runtime;
        struct snd_soc_codec *codec;
        unsigned int active;
        unsigned char pop_wait:1;
        void *dma_data;
 
        /* DAI private data */      /*DAI私有数据*/
        void *private_data;
 
        /* parent platform */      /*父平台*/
        struct snd_soc_platform *platform;
 
        struct list_head list;         /*循环、双向链表*/
};

2）CODEC IO操作、动态音频电源管理以及时钟、PLL等控制

在（1）中的snd_soc_codec 结构体是对CODEC本身I/O控制以及动态音频电源管理（Dynamic Audio Power Management，DAPM）的描述。它描述I2C、SPI或AC’97如何读写CODEC寄存器并容纳DAPM链表，核心成员为read()、write()、hw_write()、hw_read()、dapm_widgets、dapm_paths等。

位于内核源代码include/sound/soc.h

/* SoC Audio Codec */
struct snd_soc_codec {
        char *name;
        struct module *owner;
        struct mutex mutex;
        struct device *dev;
        struct snd_soc_device *socdev;
 
        struct list_head list;
 
        /* callbacks */
        int (*set_bias_level)(struct snd_soc_codec *,
                                  enum snd_soc_bias_level level);
 
        /* runtime */
        struct snd_card *card;
        struct snd_ac97 *ac97;  /* for ad-hoc ac97 devices */
        unsigned int active;
        unsigned int pcm_devs;
        void *private_data;
 
        /* codec IO */
        void *control_data; /* codec control (i2c/3wire) data */
        unsigned int (*read)(struct snd_soc_codec *, unsigned int);
        int (*write)(struct snd_soc_codec *, unsigned int, unsigned int);
        int (*display_register)(struct snd_soc_codec *, char *,
                                    size_t, unsigned int);
        int (*volatile_register)(unsigned int);
        int (*readable_register)(unsigned int);
        hw_write_t hw_write;
        unsigned int (*hw_read)(struct snd_soc_codec *, unsigned int);
        void *reg_cache;
        short reg_cache_size;
        short reg_cache_step;
 
        /* dapm */
        u32 pop_time;
        struct list_head dapm_widgets;
        struct list_head dapm_paths;
        enum snd_soc_bias_level bias_level;
        enum snd_soc_bias_level suspend_bias_level;
        struct delayed_work delayed_work;
 
        /* codec DAI's */
        struct snd_soc_dai *dai;
        unsigned int num_dai;
 
#ifdef CONFIG_DEBUG_FS
        struct dentry *debugfs_reg;
        struct dentry *debugfs_pop_time;
        struct dentry *debugfs_dapm;
#endif
};

在（1）中的snd_soc_dai_ops结构体则描述CODEC的时钟、PLL以及各式设置，主要包括set_sysclk()、set_pll()、set_clkdiv()、set_fmt()等成员函数。

位于内核源代码include/sound/soc-dai.h

/*
 * Digital Audio Interface.
 *
 * Describes the Digital Audio Interface in terms of its ALSA, DAI and AC97
 * operations and capabilities. Codec and platform drivers will register this
 * structure for every DAI they have.
 *
 * This structure covers the clocking, formating and ALSA operations for each
 * interface.
 */
struct snd_soc_dai_ops {
        /*
         * DAI clocking configuration, all optional.
         * Called by soc_card drivers, normally in their hw_params.
         */    /*DAI时钟配置*/
        int (*set_sysclk)(struct snd_soc_dai *dai,
                  int clk_id, unsigned int freq, int dir);
        int (*set_pll)(struct snd_soc_dai *dai,
                  int pll_id, unsigned int freq_in, unsigned int freq_out);
        int (*set_clkdiv)(struct snd_soc_dai *dai, int div_id, int div);
 
        /*
         * DAI format configuration
         * Called by soc_card drivers, normally in their hw_params.
         */      /*DAI格式设置*/
        int (*set_fmt)(struct snd_soc_dai *dai, unsigned int fmt);
        int (*set_tdm_slot)(struct snd_soc_dai *dai,
                  unsigned int tx_mask, unsigned int rx_mask,
                  int slots, int slot_width);
        int (*set_tristate)(struct snd_soc_dai *dai, int tristate);
 
        /*
         * DAI digital mute - optional.
         * Called by soc-core to minimise any pops.
         */     /*数字静音*/
        int (*digital_mute)(struct snd_soc_dai *dai, int mute);
 
        /*
         * ALSA PCM audio operations - all optional.
         * Called by soc-core during audio PCM operations.
         */    /*在操作PCM时由soc-core调用进行PCM操作*/
          /*音频流开始采集和播放时的一些动作*/
        int (*startup)(struct snd_pcm_substream *,
                  struct snd_soc_dai *);    /*启动*/
        void (*shutdown)(struct snd_pcm_substream *,
                  struct snd_soc_dai *);    /*关闭*/
        int (*hw_params)(struct snd_pcm_substream *,
                  struct snd_pcm_hw_params *, struct snd_soc_dai *);  /*硬件参数设置*/
        int (*hw_free)(struct snd_pcm_substream *,
                  struct snd_soc_dai *);    /*硬件参数释放*/
        int (*prepare)(struct snd_pcm_substream *,
                  struct snd_soc_dai *);    /*准备*/
        int (*trigger)(struct snd_pcm_substream *, int,
                  struct snd_soc_dai *);    /*在PCM被开始、停止或暂停时被调用*/
};

（3）CODEC的mixer控制

ASoC中定义了一组宏来描述CODEC的mixer控制，这组宏可以方便地将mixer名和对应的寄存器进行绑定，主要包括：

位于内核源代码include/sound/soc.h

/* mixer control */  /*mixer控制*/
struct soc_mixer_control {
        int min, max;
        unsigned int reg, rreg, shift, rshift, invert;
};     
/* enumerated kcontrol */  /*枚举控制*/
struct soc_enum {
        unsigned short reg;
        unsigned short reg2;
        unsigned char shift_l;
        unsigned char shift_r;
        unsigned int max;
        unsigned int mask;
        const char **texts;
        const unsigned int *values;
        void *dapm;
};

SOC_SINGLE(xname, reg, shift, max, invert) /*参数xname是mixer的名字，reg是控制该mixer的寄存器，shift对应寄存器内的位，max是进行操作时的最大数，invert表明是否极性倒序或翻转*/

SOC_DOUBLE(xname, xreg, shift_left, shift_right, xmax, xinvert)

SOC_ENUM(xname, xenum)

SOC_ENUM_SINGLE(xreg, xshift, xmax, xtexts)

/*带x的，如xreg、xmax、xinvert、xenum、xshift、xtexts数据类型是unsigned long，不带x的为默认类型，见上面两个结构体。

4）CODEC音频操作

在ASoC驱动的CODEC部分也需要关心音频流开始采集和播放时的一些动作，如hw_params()、hw_free()、prepare()、trigger()这些操作，不过与原始ALSA不同的是，在CODEC驱动的这些函数中，不关心CPU端，而只关心CODEC本身，由结构体and_soc_ops描述。

位于内核源代码include/sound/soc.h

/* SoC audio ops */
struct snd_soc_ops {
        int (*startup)(struct snd_pcm_substream *);
        void (*shutdown)(struct snd_pcm_substream *);
        int (*hw_params)(struct snd_pcm_substream *, struct snd_pcm_hw_params *);
        int (*hw_free)(struct snd_pcm_substream *);
        int (*prepare)(struct snd_pcm_substream *);
        int (*trigger)(struct snd_pcm_substream *, int);
};

这个结构体在linux2.6.32.2中已经使用位于include/sound/soc-dai.h中snd_soc_dai_ops结构体来描述，见sound/soc/codecs/uda134x.c

以上是对于ASoC CODEC驱动的工作进行描述和几个重要的数据结构。

2.ASoC平台驱动

首先，在ASoC平台驱动部分，同样存在着CODEC驱动中的snd_soc_dai、snd_soc_dai_ops、snd_soc_ops（这个结构体在linux2.6.32.2中已经交给snd_soc_dai_ops结构体来描述）这3个结构体的实例用于描述DAI和DAI上操作，不过不同的是，在平台驱动中，它们只描述CPU相关的部分而不描述CODEC。除此之外，在ASoC平台驱动中，必须实现完整的DMA驱动，即传统ALSA的snd_pcm_ops结构体成员函数trigger()、pointer()等。因此ASoC平台驱动通常由DAI和DMA两部分组成：

snd_soc_dai、snd_soc_dai_ops、snd_soc_ops这3个结构体和在CODEC驱动中一样，只是在这里只描述CPU相关的部分，对CPU中设计到的寄存器进行设置；

snd_pcm_ops结构体描述DMA操作和设置；

snd_pcm_ops结构体

位于内核源代码include/sound/pcm.h

struct snd_pcm_ops {
        int (*open)(struct snd_pcm_substream *substream);
        int (*close)(struct snd_pcm_substream *substream);
        int (*ioctl)(struct snd_pcm_substream * substream,
                      unsigned int cmd, void *arg);  /*驱动中通常可以给ioctl()成员函数传递通用的snd_pcm_lib_ioctl()函数*/
        int (*hw_params)(struct snd_pcm_substream *substream,
                             struct snd_pcm_hw_params *params);  /* hw_params()成员函数将在应用程序设置硬件参数（PCM子流的周期大小、缓冲区大小和格式等）的时候被调用*/
        int (*hw_free)(struct snd_pcm_substream *substream);  /*释放由hw_params()分配的资源*/
        int (*prepare)(struct snd_pcm_substream *substream);  /*当PCM被“准备”时，prepare()函数被调用，在其中可以设置采样率、格式等*/
        int (*trigger)(struct snd_pcm_substream *substream, int cmd);  /*trigger()成员函数在PCM被开始、停止或暂停时调用*/
        snd_pcm_uframes_t (*pointer)(struct snd_pcm_substream *substream);  /*pointer()函数用于PCM中间层查询目前缓冲区的硬件设置，该函数以帧的形式返回0~buffer_sise-1的位置（ALSA 0.5.x中为字节形式），此函数也是原子的*/
        int (*copy)(struct snd_pcm_substream *substream, int channel,
                      snd_pcm_uframes_t pos,
                      void __user *buf, snd_pcm_uframes_t count);
        int (*silence)(struct snd_pcm_substream *substream, int channel,
                        snd_pcm_uframes_t pos, snd_pcm_uframes_t count);
        struct page *(*page)(struct snd_pcm_substream *substream,
                                unsigned long offset);
        int (*mmap)(struct snd_pcm_substream *substream, struct vm_area_struct *vma);
        int (*ack)(struct snd_pcm_substream *substream);
};

3.ASoC板驱动

ASoC板驱动直接与板对应，对于一块确定的电路板，其SoC和CODEC都是确定的，因此板驱动将ASoC CODEC驱动和CPU端的平台驱动进行绑定，这个绑定用数据结构snd_soc_dai_link描述

位于内核源代码include/sound/soc.h

/* SoC machine DAI configuration, glues a codec and cpu DAI together */
struct snd_soc_dai_link  {
        char *name;                      /* Codec name */
        char *stream_name;                /* Stream name */
 
        /* DAI */
        struct snd_soc_dai *codec_dai;
        struct snd_soc_dai *cpu_dai;
 
        /* machine stream operations */  /*板流操作*/
        struct snd_soc_ops *ops;
 
        /* codec/machine specific init - e.g. add machine controls */
    /*codec/machine 特定的初始化*/
        int (*init)(struct snd_soc_codec *codec);
 
        /* Symmetry requirements */
        unsigned int symmetric_rates:1;
 
        /* Symmetry data - only valid if symmetry is being enforced */
        unsigned int rate;
 
        /* DAI pcm */
        struct snd_pcm *pcm;
};

原文地址：http://www.linuxidc.com/Linux/2012-10/73066.htm