ALSA 驱动框架和驱动开发 (一)
2019-07-13 20:09发布
生成海报
音频设备接口包括PCM IIS AC97三大类
两种音频驱动框架:ALSA
和 OSS
OSS包含DSP和MIXER字符设备接口,完全使用文件操作
ALSA以CARD和组件(PCM,mixer等)为主线,在用户空间的变成中不适用文件接口,而是使用alsalib,而下文要介绍的没有使用ALSAlib,而是使用了OSS
lib
接口芯片为PCM系列
Linux 2.6.26
ARM9 AT91
首先,说明ALSA的driver部分
一,基本方法:
先说明整个ALSA的体系,如下图所示,
直接提供给用户空间操作的文件操作方法是由oss层提供的,包括pcm_oss.c和mixer_oss.c,如果编写一个pcm的驱动话,是在ALSA_driver层,包括的文件为at91_pcmXXX.c和pcmXXX.c,驱动编写的主要思想是,通过probe将一个新的snd_soc_codec
*codec结构填充,然后调用snd_soc_new_pcms注册一系列的pcm接口,最后调用snd_soc_register_card注册声卡
(假设走的是先注册驱动,在注册设备的流程,二者谁先谁后都一样,事实上先注册的确实是驱动)
a) soc-core.c
首先注册了一个平台驱动,
static struct platform_driver soc_driver = {
.driver = {
.name = "soc-audio",
},
.probe = soc_probe,
.remove = soc_remove,
.suspend = soc_suspend,
.resume = soc_resume,
};
如果在没有设备名为“soc-audio”的设备时,则不调用.Probe
b) at91_pcmXXX.c
同样,在epayment_snd_init中,先申请一个SSC设备(申请涉及到atmel_ssc.o模块),接着注册了一个platform的设备,起名字为“soc-audio”,该平台设备的driver_data为epayment_snd_devdata指针,该私有数据指针为struct
snd_soc_device的指针,使能SSC时钟。
此时,由于platform总线下的设备和驱动名字匹配,则调用driver的probe方法。
c) .probe=soc_probe
Struct snd_soc_device包含四个结构,
分别是
Struct snd_soc_machine
Struct snd_soc_platform
Struct snd_soc_codec_device
Struct snd_soc_codec_drvdata
Probe中调用的顺序为,
Soc_core(probe)
àcpu àplatform
àcodec
Machine probe null
Cpu_dai probe null
Codec_dev->probe pcmXXX probe(pcmXXX.c)
Platform probe null
最后初始化一个工作,在进行close(shutdown)操作时调用,该工作是保证在结束播放后,延时一定时间,保证资源全部释放之后,在进行最终结束操作。
而对于PcmXXX.probe,
该函数的主要工作就是分配一个新的snd_soc_codec *codec结构,然后通过它注册PCM接口和卡设备
具体来说,PcmXXX_init(),codec的各个参量的初始化及其注册
Codec->private_data=pcmXXXpri,
Codec->dai=&pcmXXX_dai
Codec->num_dai=1
接着调用snd_soc_new_pcms注册一系列的pcm接口
调用snd_soc_register_card注册声卡
上述两个操作都是soc-core的操作
d) 对于ALSA的open/write/read/ioctl(用于配置参数和prepare),如果驱动调用相关操作时,会大致根据 àcpu
àplatform àcodec的顺序进行相关方法的调用,具体的如下,CPU(machine)包括cpu接口和codec接口。
以上就是简单的借用platform driver完成的pcm设备驱动程序框架。
二.Atmel_ssc.o
首先在板级程序中通过调用at91_add_device_ssc添加了SSC设备,
其中
static struct platform_device at91sam9260_ssc_device = {
.name = "ssc",
.id = 0,
.dev = {
.dma_mask = &ssc_dmamask,
.coherent_dma_mask = DMA_BIT_MASK(32),
},
.resource = ssc_resources,
.num_resources = ARRAY_SIZE(ssc_resources),
};
其中resource包括irq和iomem。
在atmel_ssc driver中,name均为ssc,于是调用driver的probe函数。
Probe函数中,申请ssc_device结构指针ssc,填充ssc,包括iomem,irq,clk,pdev等,最后将ssc添加到ssc_list中。
spin_lock(&user_lock);
list_add_tail(&ssc->list, &ssc_list);
spin_unlock(&user_lock);
这样就完成了driver的注册,此时ssc_list不为空,查看ssc_request函数知道,申请ssc设备就是遍历ssc_list,然后查找设备号是否一致,如果一致且设备无人使用,则返回该结构的指针,完成设备的申请过程,并且使能SSC时钟。
三.SOC-CORE
a)
snd_soc_new_pcms
对应于controlC0设备和PCMC0D0P设备
该函数首先创建一个新的声卡卡结构(调用snd_card_new),然后根据num_links,分别调用soc_new_pcm创建新的pcm接口
---àsnd_card_new 将controlC0设备添加到card->devices中
具体就是, codec->card = snd_card_new(idx, xid, codec->owner, 0);
(这里使用codec->owner计数的原因是,一个card可以对应多个pcm流,但是一个card不能被多个pcm流占用计数,所以编码器的owner即为card的owner)
---àsnd_ctl_create
创建一个新的卡设备,name为CONTROL,定义相应的卡设备操作,这里指CONTROL设备的snd_device_ops,
static struct snd_device_ops ops = {
.dev_free = snd_ctl_dev_free,
.dev_register = snd_ctl_dev_register,
.dev_disconnect = snd_ctl_dev_disconnect,
};
snd_device_new(card, SNDRV_DEV_CONTROL, card, &ops)
然后将该卡结构(通过dev->list)添加到card->devices队列中(实际注册这些设备时通过遍历card->devices,然后调用各自的dev_register方法,对自身注册)
---àsnd_info_card_create,创建一个卡的proc文件
---àsoc_new_pcm 将PCMC0D0P设备添加到card->devices中
同样的,ret = soc_new_pcm(socdev, &machine->dai_link[i], i);
这里有两个新数据结构
一个是struct snd_soc_pcm_runtime *rtd(runtime data )
Struct snd_soc_pcm_runtime
{
Struct snd_soc_dai_link *dai;
Struct snd_soc_device *socdev;
}
一个是struct snd_pcm *pcm
Pcm->private_data=rtd;
---àsnd_pcm_new(pcm.c)
同snd_ctl_create,一样的生成一个PCM device
具体涉及如下:
static struct snd_device_ops ops = {
.dev_free = snd_pcm_dev_free,
.dev_register = snd_pcm_dev_register,
.dev_disconnect = snd_pcm_dev_disconnect,
};
snd_device_new(card, SNDRV_DEV_PCM, pcm, &ops))
然后将该卡结构(通过dev->list)添加到card->devices队列中(实际注册这些设备时通过遍历card->devices,然后调用各自的dev_register方法,对自身注册)
---àsnd_pcm_set_ops(….., &soc_pcm_ops)
Soc_pcm_ops为pcm相关操作的指针
---àsocdev->platform->pcm_new
具体的函数为at91_pcm_new
该函数主要为DMA传输设置DAM MASK
和提前分配DMA buffer,包括playbakc和capture的
---à最后,pcm->private_free=socdev->platform->pcm_free
b) snd_soc_register_card
---àsnd_card_register(codec->card)
----àsnd_device_register_all(card)
这里将card->devices中的device分别注册,调用各自的device_ops中的.dev_register进行注册,实际上只有两个设备,control和pcm.
一个是control设备controlC0,
Control调用的是自身的snd_ctl_dev_register
注册control设备,Control设备有其相应的设备操作方法,PCM设备也有其相应的设备操作方法。
一个是pcm设备PCMC0D0P,
PCM调用的是自身的snd_pcm_dev_register
设置PCM设备的名字,然后针对不同的设备用途,是playback流还是capture流,分别注册不同的操作方法,我们这里只有一个playback,所以只注册了playback的方法,cidx=0,函数的调用如下,
1).snd_register_device_for_dev
这里真正的调用device_create,通过pcm->device这一嵌套的device注册了设备(PCM)
2).snd_add_device_sysfs_file添加设备信息到sysfs中
3).snd_pcm_timer_init
该部分创建了timer设备,具体见pcm_timer
4)
list_for_each_entry(notify, &snd_pcm_notify_list, list)
notify->n_register(pcm);
正是在这里注册了/dev/dsp , /dev/audio,snd_pcm_notify_list的由来,具体看PCM_OSS.O模块
----choose_default_id(card)
----àinit_info_for_card(card) proc文件的初始化
----à snd_mixer_oss_notify_callback
由于定义了
#ifdefined(CONFIG_SND_MIXER_OSS)||defined(CONFIG_SND_MIXER_OSS_MODULE)
所以mixer_oss模块被调用 在这里注册了mixer这一设备。具体见mixer_oss模块
---àsnd_soc_dapm_sys_add(socdev->dev)添加电源管理
三.PCM_OSS模块
在dev/目录下,可以看到6个与audio有关的设备,包括
mixer,dsp,audio,controlC0,pcmC0D0P,timer
从上面的图可以直观的说明它们的关系,对dsp设备文件的操作(OSS层),最终是调用pcm.o提供的方法,同样,对mixer设备文件的操作最终调用的是control.o提供的方法。
在alsa_pcm_oss_init中,先初始化dsp_map[i]全为0,adsp_map[i]全为1(default设置),检查合理,然后调用snd_pcm_notify(&snd_pcm_oss_notify,
0)
在snd_pcm_notify函数中,
将snd_pcm_oss_notify加入到snd_pcm_notify_list中,即
list_add_tail(¬ify->list, &snd_pcm_notify_list);
然后遍历snd_pcm_devices,找出链表中的已经添加的PCM,然后调用notify中的.n_register进行注册,也即
list_for_each_entry(pcm, &snd_pcm_devices, list)
notify->n_register(pcm);
在init中是没有PCM接口的,所以为空,只有在添加了PCM接口后,才会有一个,那就是上面soc_core中所说的。
在snd_soc_register_card中,最后创建/dev/dsp和/dev/audio时,是通过遍历notify list,然后调用对应的n_register完成的。
list_for_each_entry(notify, &snd_pcm_notify_list, list)
notify->n_register(pcm);
在链表snd_pcm_notify_list中,只有一个notify,就是上面注册了的snd_pcm_oss_notify
而snd_pcm_oss_notify的.n_register实际调用的就是
Snd_pcm_oss_register_minor(struct snd_pcm *pcm)
具体的,
Snd_pcm_oss_register_minor---à Register_oss_dsp(pcm,0)----àsnd_register_oss_device
通过snd_register_oss_device,建立了最上层的文件操作接口,该文件就是/dev/dsp文件和/dev/audio文件
snd_register_oss_device的具体调用为
register_sound_special_device(f_ops,3, carddev); dsp
register_sound_special_device(f_ops,4, carddev); audio
最终调用
sound_insert_unit(&chains[chain],fops, -1, unit, max_unit,
name, S_IRUSR | S_IWUSR, dev);
sound_insert_unit调用两个,
r = __sound_insert_unit(s, list, fops, index, low, top)插入到chains链表中和device_create创建设备和文件
最后adsp_map[0]!=pcm->device,前者为1,跳过最后snd_pcm_oss_proc_init(pcm),为proc oss init
以上就是建立设备文件/dev/dsp,/dev/audio,并将它们链入Chains的过程。
四.mixer_OSS模块
在初始化的过程中将snd_mixer_oss_notify_callback这一函数指针赋值为snd_mixer_oss_notify_handler,但是由于初始化过程中,snd_cards为空,所以未建立mixer设备文件,直到在最终的初始化后建立了MIXER设备
在soc_core中提到最后会通过调用snd_mixer_oss_notify_callback创建mixer设备文件。
具体的,就是在该snd_mixer_oss_notify_handler中,调用如下,
----à snd_register_oss_device
将MIXER注册。
----à snd_mixer_oss_build
建立oss mixer element,该函数又调用.
----à snd_mixer_oss_build_input该函数主要完成struct snd_mixer_oss_slot *rslot的填充,包括put_volume,get_volume,get_recsrc,put_recsrc等.
----àsnd_mixer_oss_proc_init 初始化oss mixer的proc文件.
Mixer_oss的相关操作是建立在得到mixer这一个kcontrol结构指针的基础上的,因为PCM没有相应的control寄存器,所以具体的mixer_oss的相关操作没有实现(control的相关操作亦没有实现)
五.Pcm_timer.c和 timer.c
a)
Timer接口 为支持声音的同步事件提供访问声卡上的定时器。
Snd_pcm_timer_init函数,首先通过snd_timer_new创建一个timer设备(这里也定义了设备的相关方法),并且将其添加到Chains链表中,然后通过snd_device_register将Chains链表中的timer设备找到,并调用它自身的.dev_register将自身注册。注册之后,就能在/dev/目下看到timer设备了。
以上基本与前面提到的dsp/audio和mixer 的注册一致。
同时,在init函数中,做了对timer的填充和一些赋值操作,包括
Timer->hw=snd_pcm_timer,
Subtream->timer=timer
Timer->private_data=substream,
Timer->private_free=snd_pcm_timer_free
而snd_pcm_timer_free的定义如下,
static struct snd_timer_hardware snd_pcm_timer =
{
.flags = SNDRV_TIMER_HW_AUTO | SNDRV_TIMER_HW_SLAVE,
.resolution = 0,
.ticks = 1,
.c_resolution = snd_pcm_timer_resolution,
.start = snd_pcm_timer_start,
.stop = snd_pcm_timer_stop,
};
这些参数在snd_timer_notify中被用到.
b)
Timer.c中snd_timer_notify在Write操作时的.post_action中被调用到,
首先被调用的是
Timer->hw.c_resolution,即snd_pcm_timer_resolution,该函数的到runtime的resolution
接下来就是
list_for_each_entry(ti, &timer->active_list_head, active_list) {
if (ti->ccallback)
ti->ccallback(ti, event, tstamp, resolution);
list_for_each_entry(ts, &ti->slave_active_head, active_list)
if (ts->ccallback)
ts->ccallback(ts, event, tstamp, resolution);
}
实际中,我们编写的PCMXXX驱动的定时器链表timer->active_list_head为空,所以不执行就直接返回了。
由于timer接口是为支持声音的同步事件提供访问声卡上的定时器,所以不提供也能正常使用。
六.Control.c
控制接口control对于许多开关(switch)和调节器(slider)而言应用相当广泛,它能从用户空间被存取。control的最主要用途是mixer,所有的mixer元素基于control
内核API 实现,在ALSA中,control
用snd_kcontrol结构体描述。
创建一个control,调用snd_ctl_add()和snd_ctl_new1()这两个函数来完成,步骤为
snd_ctl_new1()函数用于创建一个snd_kcontrol并返回其指针,snd_ctl_add()函数用于将创建的snd_kcontrol添加到对应的card
中。
如果需要创建control,可以在pcmXXX.c中的pcm_probe中进行实现不过由于pcm没有支持的control寄存器,所以probe中也没有进行此操作。
七.电源管理
Pcm驱动中也没有提供电源管理的control结构,例如在WM8731中就有相应的设置,这是由芯片决定的,
wm8731_add_controls(codec) 添加control至card->controls链表中,然后遍历链表将这些control接口全部注册。
wm8731_add_widgets(codec) 添加dapm control
至于设备的suspend和resume,pcmXXX虽然有此函数,不过可以不用实现,因为连接的串口处于suspend时,pcm也就没有数据处理的过程,这种从设备的形式的suspend和resume就可以不用实现。
Suspend过程包括两个方面,
At91-ssc.c中的suspend和resume(cpu)
当ssc处于suspend的状态时,保存此时SSC相关寄存器的值,待resume被调用时恢复。这些寄存器包括,SR,CMR,RCMR,RFMR,TCMR,TFMR等。
At91-pcm.c中的suspend和resume(platform),
至于平台的suspend,设计的就是PDC。在suspend时,禁止DMA传输,同时将PDC相关寄存器,包括XPR,XCR,XNPR,XNCR保存,待resume时恢复,进行继续的传输过程。
八.ALSA中的链表结构
在ALSA中设计到很多的链表结构,理解这些链表能更好的理解ALSA
a)
card->devices
card->devices链表的建立方便了card相关设备的注册过程和设备的管理。通过这个链表,在注册设备的过程中,可以先将设备(包括设备编号,设备相应的操作指针等)添加进链表中,然后再遍历链表,各自的设备调用本身的注册函数将自身注册,完成card相关所有设备的注册过程。
b)
snd_pcm_devices
该链表结构则是为了将已经存在了的PCM接口链接到该链表上,方便pcm的管理
c)
snd_pcm_notify_list
此链表是为pcm注册的通用方法,如果只注册了一个snd_pcm_oss_notify
,则在遍历snd_pcm_devices时,查找到的pcm device均使用该notify的.n_register进行PCM的注册。
d)
card->controls
cadr->controls链表和card->devices链表类似,只不过一个负责管设备,一个负责管控制接口,基本操作类似,不过PCM中没有相关寄存器,所以未应用.
e)
snd_control_ioctls
与control有关的链表,如果在control中snd_ctl_add则是将control添加到此链表中。
f)
timer->active_list_head
与timer有关的链表
九.驱动中各个结构体和各个模块的关系
a) soc_core所用到的各个结构体之间的关联图,可以说是体系中的CORE层。如下,
从上图中看,soc_core中多数函数以soc_device指针为函数参量的原因也很显然。
而遵循soc_core的调用关系,即cpu----platform----codec,在上述结构总很好的体现。
还有一个重要的结构就是runtime,该结构代表的是
打开微信“扫一扫”,打开网页后点击屏幕右上角分享按钮