ASoC Codec驱动程序
编解码器类驱动程序是通用且独立于硬件的代码,用于配置编解码器、FM、MODEM、BT 或外部 DSP 以提供音频播放和录音。它不应包含特定于目标平台或机器的代码。所有平台和机器特定代码都应添加到平台中。
Codec驱动所在的目录: sound/soc/codecs/
每个编解码器类驱动程序必须提供以下功能:
- Codec DAI 和 PCM的 配置
- Codec 控制 IO,使用 RegMap API
- 混音器和音频控制
- Codec音频操作
- DAPM 说明。
- DAPM 事件处理程序。
可选项:
7. DAC 数字mute控制。
Codec DAI 和 PCM 配置
由 struct snd_soc_dai_driver 来定义它的 DAI 和PCM 功能和操作。这个结构被导出被导出后内核注册。
e.g
static struct snd_soc_dai_ops wm8731_dai_ops = {
.prepare = wm8731_pcm_prepare,
.hw_params = wm8731_hw_params,
.shutdown = wm8731_shutdown,
.digital_mute = wm8731_mute,
.set_sysclk = wm8731_set_dai_sysclk,
.set_fmt = wm8731_set_dai_fmt,
};
struct snd_soc_dai_driver wm8731_dai = {
.name = "wm8731-hifi",
.playback = {
.stream_name = "Playback",
.channels_min = 1,
.channels_max = 2,
.rates = WM8731_RATES,
.formats = WM8731_FORMATS,},
.capture = {
.stream_name = "Capture",
.channels_min = 1,
.channels_max = 2,
.rates = WM8731_RATES,
.formats = WM8731_FORMATS,},
.ops = &wm8731_dai_ops,
.symmetry_rates = 1,
};
Codec控制
Codec通常可以通过 I2C 或 SPI 接口进行控制(AC97 将结合控制数据和音频合并起来)。Codec驱动程序应使用所有Codec IO 的 Regmap API。可见 include/linux/regmap.h 和目录下的Codec驱动程序,借鉴regmap 用法。
混音器和音频控制
所有Codec混音器和音频控件都可以使用soc.h 中定义的宏。
#define SOC_SINGLE(xname, reg, shift, mask, invert)
定义单个控件如下:
xname = Control name e.g. "Playback Volume" reg = codec寄存器 shift = 寄存器中的控制位偏移 mask = 控制位大小,例如7 = 3 位掩码 invert = 控制反转
其他宏定义:
#define SOC_DOUBLE(xname, reg, shift_left, shift_right, mask, invert)
立体声控制
#define SOC_DOUBLE_R(xname, reg_left, reg_right, shift, mask, invert)
跨越 2 个寄存器的立体声控制
#define SOC_ENUM_SINGLE(xreg, xshift, xmask, xtexts)
定义单个枚举控件如下:
xreg = 注册
xshift = 寄存器中的控制位偏移
xmask = 控制位大小
xtexts = 指向描述每个设置的字符串数组的指针
#define SOC_ENUM_DOUBLE(xreg, xshift_l, xshift_r, xmask, xtexts)
Codec音频操作
编解码器驱动程序还支持以下 ALSA PCM 操作:
/* 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 *);
};
有关详细信息,请参阅 ALSA 驱动程序 PCM 文档。
http://www.alsa-project.org/~iwai/writing-an-alsa-driver/
DAPM 说明
动态音频电源管理描述了Codec电源组件及其关系和到 ASoC core的寄存器。具体再请阅读 dapm.txt。
DAPM 事件处理程序
该函数是一个回调,处理了Codec PM 调用和系统 PM 调用(例如挂起和恢复)。
电源状态:
SNDRV_CTL_POWER_D0: /* full On */
/* vref/mid, clk and osc on, active */
SNDRV_CTL_POWER_D1: /* partial On */
SNDRV_CTL_POWER_D2: /* partial On */
SNDRV_CTL_POWER_D3hot: /* Off, with power */
/* everything off except vref/vmid, inactive */
SNDRV_CTL_POWER_D3cold: /* Everything Off, without power */
Codec DAC 数字静音控制
大多数Codec在 DAC 之前都有一个数字静音,可用于尽量减少任何系统噪音。Mute操作阻止任何数字数据进入 DAC。
可以为每个编解码器 DAI 创建一个由核心调用的回调当mute被使用或释放。
static int wm8974_mute(struct snd_soc_dai *dai, int mute)
{
struct snd_soc_codec *codec = dai->codec;
u16 mute_reg = snd_soc_read(codec, WM8974_DAC) & 0xffbf;
if (mute)
snd_soc_write(codec, WM8974_DAC, mute_reg | 0x40);
else
snd_soc_write(codec, WM8974_DAC, mute_reg);
return 0;
}