博客

/* SoC Audio Codec device */
struct snd_soc_codec {
	const char *name;  /* Codec的名字*/
	struct device *dev; /* 指向Codec设备的指针 */
	const struct snd_soc_codec_driver *driver; /* 指向该codec的驱动的指针 */
	struct snd_soc_card *card;    /* 指向Machine驱动的card实例 */
	int num_dai; /* 该Codec数字接口的个数，目前越来越多的Codec带有多个I2S或者是PCM接口 */
	int (*volatile_register)(...);  /* 用于判定某一寄存器是否是volatile */
	int (*readable_register)(...);  /* 用于判定某一寄存器是否可读 */
	int (*writable_register)(...);  /* 用于判定某一寄存器是否可写 */

	/* runtime */
	......
	/* codec IO */
	void *control_data; /* 该指针指向的结构用于对codec的控制，通常和read，write字段联合使用 */
	enum snd_soc_control_type control_type;/* 可以是SND_SOC_SPI，SND_SOC_I2C，SND_SOC_REGMAP中的一种 */
	unsigned int (*read)(struct snd_soc_codec *, unsigned int);  /* 读取Codec寄存器的函数 */
	int (*write)(struct snd_soc_codec *, unsigned int, unsigned int);  /* 写入Codec寄存器的函数 */
	/* dapm */
	struct snd_soc_dapm_context dapm;  /* 用于DAPM控件 */
};

snd_soc_codec_driver:

/* codec driver */
struct snd_soc_codec_driver {
	/* driver ops */
	int (*probe)(struct snd_soc_codec *);  /* codec驱动的probe函数，由snd_soc_instantiate_card回调 */
	int (*remove)(struct snd_soc_codec *);  
	int (*suspend)(struct snd_soc_codec *);  /* 电源管理 */
	int (*resume)(struct snd_soc_codec *);  /* 电源管理 */

	/* Default control and setup, added after probe() is run */
	const struct snd_kcontrol_new *controls;  /* 音频控件指针 */
	const struct snd_soc_dapm_widget *dapm_widgets;  /* dapm部件指针 */
	const struct snd_soc_dapm_route *dapm_routes;  /* dapm路由指针 */

	/* codec wide operations */
	int (*set_sysclk)(...);  /* 时钟配置函数 */
	int (*set_pll)(...);  /* 锁相环配置函数 */

	/* codec IO */
	unsigned int (*read)(...);  /* 读取codec寄存器函数 */
	int (*write)(...);  /* 写入codec寄存器函数 */
	int (*volatile_register)(...);  /* 用于判定某一寄存器是否是volatile */
	int (*readable_register)(...);  /* 用于判定某一寄存器是否可读 */
	int (*writable_register)(...);  /* 用于判定某一寄存器是否可写 */

	/* codec bias level */
	int (*set_bias_level)(...);  /* 偏置电压配置函数 */

};

snd_soc_dai:

/*
 * Digital Audio Interface runtime data.
 *
 * Holds runtime data for a DAI.
 */
struct snd_soc_dai {
	const char *name;  /* dai的名字 */
	struct device *dev;  /* 设备指针 */

	/* driver ops */
	struct snd_soc_dai_driver *driver;  /* 指向dai驱动结构的指针 */

	/* DAI runtime info */
	unsigned int capture_active:1;		/* stream is in use */
	unsigned int playback_active:1;		/* stream is in use */

	/* DAI DMA data */
	void *playback_dma_data;  /* 用于管理playback dma */
	void *capture_dma_data;  /* 用于管理capture dma */

	/* parent platform/codec */
	union {
		struct snd_soc_platform *platform;  /* 如果是cpu dai，指向所绑定的平台 */
		struct snd_soc_codec *codec;  /* 如果是codec dai指向所绑定的codec */
	};
	struct snd_soc_card *card;  /* 指向Machine驱动中的crad实例 */
};

snd_soc_dai_driver:

/*
 * Digital Audio Interface Driver.
 *
 * 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_driver {
	/* DAI description */
	const char *name;  /* dai驱动名字 */

	/* DAI driver callbacks */
	int (*probe)(struct snd_soc_dai *dai);  /* dai驱动的probe函数，由snd_soc_instantiate_card回调 */
	int (*remove)(struct snd_soc_dai *dai);  
	int (*suspend)(struct snd_soc_dai *dai);  /* 电源管理 */
	int (*resume)(struct snd_soc_dai *dai);  

	/* ops */
	const struct snd_soc_dai_ops *ops;  /* 指向本dai的snd_soc_dai_ops结构 */

	/* DAI capabilities */
	struct snd_soc_pcm_stream capture;  /* 描述capture的能力 */
	struct snd_soc_pcm_stream playback;  /* 描述playback的能力 */
};

snd_soc_dai_ops用于实现该dai的控制盒参数配置：

struct snd_soc_dai_ops {
	/*
	 * DAI clocking configuration, all optional.
	 * Called by soc_card drivers, normally in their hw_params.
	 */
	int (*set_sysclk)(...);
	int (*set_pll)(...);
	int (*set_clkdiv)(...);
	/*
	 * DAI format configuration
	 * Called by soc_card drivers, normally in their hw_params.
	 */
	int (*set_fmt)(...);
	int (*set_tdm_slot)(...);
	int (*set_channel_map)(...);
	int (*set_tristate)(...);
	/*
	 * DAI digital mute - optional.
	 * Called by soc-core to minimise any pops.
	 */
	int (*digital_mute)(...);
	/*
	 * ALSA PCM audio operations - all optional.
	 * Called by soc-core during audio PCM operations.
	 */
	int (*startup)(...);
	void (*shutdown)(...);
	int (*hw_params)(...);
	int (*hw_free)(...);
	int (*prepare)(...);
	int (*trigger)(...);
	/*
	 * For hardware based FIFO caused delay reporting.
	 * Optional.
	 */
	snd_pcm_sframes_t (*delay)(...);
};

static struct platform_driver wm8994_codec_driver = {
	.driver = {
		   .name = "wm8994-codec",
		   .owner = THIS_MODULE,
		   },
	.probe = wm8994_probe,
	.remove = __devexit_p(wm8994_remove),
};

module_platform_driver(wm8994_codec_driver);

有platform driver，必定会有相应的platform device，这个platform device的来源后面再说，显然，platform driver注册后，probe回调将会被调用，这里是wm8994_probe函数：

static int __devinit wm8994_probe(struct platform_device *pdev)
{
	return snd_soc_register_codec(&pdev->dev, &soc_codec_dev_wm8994,
			wm8994_dai, ARRAY_SIZE(wm8994_dai));
}

其中，soc_codec_dev_wm8994和wm8994_dai的定义如下（代码中定义了3个dai，这里只列出第一个）：

static struct snd_soc_codec_driver soc_codec_dev_wm8994 = {
	.probe =	wm8994_codec_probe,
	.remove =	wm8994_codec_remove,
	.suspend =	wm8994_suspend,
	.resume =	wm8994_resume,
	.set_bias_level = wm8994_set_bias_level,
	.reg_cache_size	= WM8994_MAX_REGISTER,
	.volatile_register = wm8994_soc_volatile,
};

static struct snd_soc_dai_driver wm8994_dai[] = {
	{
		.name = "wm8994-aif1",
		.id = 1,
		.playback = {
			.stream_name = "AIF1 Playback",
			.channels_min = 1,
			.channels_max = 2,
			.rates = WM8994_RATES,
			.formats = WM8994_FORMATS,
		},
		.capture = {
			.stream_name = "AIF1 Capture",
			.channels_min = 1,
			.channels_max = 2,
			.rates = WM8994_RATES,
			.formats = WM8994_FORMATS,
		 },
		.ops = &wm8994_aif1_dai_ops,
	},
	......
}

可见，Codec驱动的第一个步骤就是定义snd_soc_codec_driver和snd_soc_dai_driver的实例，然后调用

snd_soc_register_codec函数对Codec进行注册。进入

snd_soc_register_codec函数看看：

	codec = kzalloc(sizeof(struct snd_soc_codec), GFP_KERNEL);

确定codec的名字，这个名字很重要，Machine驱动定义的snd_soc_dai_link中会指定每个link的codec和dai的名字，进行匹配绑定时就是通过和这里的名字比较，从而找到该Codec的！

/* create CODEC component name */
	codec->name = fmt_single_name(dev, &codec->id);

	codec->write = codec_drv->write;
	codec->read = codec_drv->read;
	codec->volatile_register = codec_drv->volatile_register;
	codec->readable_register = codec_drv->readable_register;
	codec->writable_register = codec_drv->writable_register;
	codec->dapm.bias_level = SND_SOC_BIAS_OFF;
	codec->dapm.dev = dev;
	codec->dapm.codec = codec;
	codec->dapm.seq_notifier = codec_drv->seq_notifier;
	codec->dapm.stream_event = codec_drv->stream_event;
	codec->dev = dev;
	codec->driver = codec_drv;
	codec->num_dai = num_dai;

在做了一些寄存器缓存的初始化和配置工作后，通过

snd_soc_register_dais函数


对本Codec的dai进行注册：

	/* register any DAIs */
	if (num_dai) {
		ret = snd_soc_register_dais(dev, dai_drv, num_dai);
		if (ret < 0)
			goto fail;
	}

最后，它把codec实例链接到全局链表codec_list中，并且调用snd_soc_instantiate_cards是函数触发Machine驱动进行一次匹配绑定操作：

	list_add(&codec->list, &codec_list);
	snd_soc_instantiate_cards();

上面的

snd_soc_register_dais函数其实也是和snd_soc_register_codec类似，显示为每个snd_soc_dai实例分配内存，确定dai的名字，用snd_soc_dai_driver实例的字段对它进行必要初始化，最后把该dai链接到全局链表dai_list中，和Codec一样，最后也会调用

snd_soc_instantiate_cards函数触发一次匹配绑定的操作。

static int wm8994_i2c_probe(struct i2c_client *i2c,
			    const struct i2c_device_id *id)
{
	struct wm8994 *wm8994;
	int ret;
	wm8994 = devm_kzalloc(&i2c->dev, sizeof(struct wm8994), GFP_KERNEL);
	i2c_set_clientdata(i2c, wm8994);
	wm8994->dev = &i2c->dev;
	wm8994->irq = i2c->irq;
	wm8994->type = id->driver_data;
	wm8994->regmap = regmap_init_i2c(i2c, &wm8994_base_regmap_config);

	return wm8994_device_init(wm8994, i2c->irq);
}

继续进入wm8994_device_init()函数，它首先为两个LDO添加mfd子设备：

	/* Add the on-chip regulators first for bootstrapping */
	ret = mfd_add_devices(wm8994->dev, -1,
			      wm8994_regulator_devs,
			      ARRAY_SIZE(wm8994_regulator_devs),
			      NULL, 0);

因为WM1811，WM8994，WM8958三个芯片功能类似，因此这三个芯片都使用了WM8994的代码，所以

wm8994_device_init()

接下来根据不同的芯片型号做了一些初始化动作，这部分的代码就不贴了。接着，从platform_data中获得部分配置信息：

	if (pdata) {
		wm8994->irq_base = pdata->irq_base;
		wm8994->gpio_base = pdata->gpio_base;

		/* GPIO configuration is only applied if it's non-zero */
		......
	}

最后，初始化irq，然后添加codec子设备和gpio子设备：

	wm8994_irq_init(wm8994);

	ret = mfd_add_devices(wm8994->dev, -1,
			      wm8994_devs, ARRAY_SIZE(wm8994_devs),
			      NULL, 0);

经过以上这些处理后，作为父设备的I2C设备已经准备就绪，它的下面挂着4个子设备：ldo-0，ldo-1，codec，gpio。其中，codec子设备的加入，它将会和前面所讲codec的platform driver匹配，触发probe回调完成下面所说的codec驱动的初始化工作。

• 
  
  为codec定义一个regmap_config结构实例，指定codec寄存器的地址和数据位等信息；
  
  
• 
  
  根据codec的控制总线类型，调用以下其中一个函数，得到一个指向regmap结构的指针：
  
  
  • 
    
    struct regmap *regmap_init_i2c(struct i2c_client *i2c, const struct regmap_config *config);
    
    
    
  • 
    
    struct regmap *regmap_init_spi(struct spi_device *dev, const struct regmap_config *config);
    
    
    
• 
  
  把获得的regmap结构指针赋值给codec->control_data；
  
  
• 
  
  调用soc-io的api：snd_soc_codec_set_cache_io使得soc-io和regmap进行关联；
  
  

完成以上步骤后，codec驱动就可以使用诸如snd_soc_read、snd_soc_write、snd_soc_update_bits等API对codec的寄存器进行读写了。