---
title: "snd_kcontrol探究"
author: "mmdev"
date: "2011-12-08T17:51:00Z"
tags: []
slug: "snd-kcontrol"
draft: false
lastmod: "2011-12-10T16:03:36Z"
id: 1301197
url: "https://mmdev.iteye.com/blog/1301197"
---

**control控制接口**

控制接口对于许多开关（switch）和调节器（slider）应用广泛，它能被用户空间存取，从而读写Codec相关寄存器。control的主要用于mixer。它用snd\_kcontrol\_new结构体描述。

**snd\_kcontrol\_new**

iface字段定义了control的类型，形式为SNDRV\_CTL\_ELEM\_IFACE\_XXX，对于mixer是SNDRV\_CTL\_ELEM\_IFACE\_MIXER，对于不属于mixer的全局控制，使用CARD；如果关联到某类设备，则是PCM、RAWMIDI、TIMER或SEQUENCER。在这里，我们主要关注mixer。

name字段是名称标识，这个字段非常重要，因为control的作用由名称来区分，对于名称相同的control，则使用index区分。下面会详细介绍上层应用如何根据name名称标识来找到底层相应的control。

name定义的标准是“SOURCE DIRECTION FUNCTION”即“源 方向 功能”，SOURCE定义了control的源，如“Master”、“PCM”等；DIRECTION 则为“Playback”、“Capture”等，如果DIRECTION忽略，意味着Playback和capture双向；FUNCTION则可以是“Switch”、“Volume”和“Route”等。

【修正】：上层也可以根据numid来找到对应的control，snd\_ctl\_find\_id()也是优先判断上层是否传递了numid，是则直接返回这个numid对应的control。用户层设置numid和control的关联时，可用alsa-lib的snd\_mixer\_selem\_set\_enum\_item()函数。snd\_kcontrol\_new结构体并没有numid这个成员，是因为numid是系统自动管理的，原则是该control的注册次序，保存到snd\_ctl\_elem\_value结构体中。

access字段是访问控制权限。SNDRV\_CTL\_ELEM\_ACCESS\_READ意味着只读，这时put()函数不必实现；SNDRV\_CTL\_ELEM\_ACCESS\_WRITE意味着只写，这时get()函数不必实现。若control值频繁变化，则需定义 VOLATILE标志。当control处于非激活状态时，应设置INACTIVE标志。

private\_value字段包含1个长整型值，可以通过它给info()、get()和put()函数传递参数。

kcontrol宏

在早期的ALSA创建一个新的control需要实现snd\_kcontrol\_new中的info、get和put这三个成员函数。现在较新版本的ALSA均定义了一些宏，如：

这个宏的对象是MIXER，对寄存器reg的位偏移shift可以设置0-max的数值。

又如：

这个宏与刚才类似，但是它是对两个寄存器reg\_left和reg\_right进行同一操作，Codec芯片中左右声道的寄存器配置一般来说是差不多的，这就是这个宏存在的意义。

例如我们一个Playback Volume的kcontrol接口这样定义：

SOC\_DOUBLE\_R\_TLV("Playback Volume", REG\_VOL\_L, REG\_VOL\_R, 0, 192, 0, digital\_tlv)

我们仅仅需要将Volume寄存器地址及位偏移，最大值填进去即可，当然这些数据要从Codec的datasheet取得。这里Volume寄存器地址是REG\_VOL\_L（左声道）和REG\_VOL\_R（右声道），位偏移为0，DAC Digital Gain范围是0-192(steps)。

为了追根究底，我们看看SOC\_DOUBLE\_R\_TLV的put函数实现：

struct snd\_ctl\_elem\_value \*ucontrol：从用户层传递下来的，这个也可以从命名看出来（kcontrol-kernel control，ucontrol-user control）；

shift是位偏移，而位掩码mask是通过宏SOC\_DOUBLE\_R\_TLV中的xmax运算得到：unsigned int mask = (1 &lt;&lt; fls(max)) - 1;

调用snd\_soc\_update\_bits()-&gt;snd\_soc\_write()将ucontrol的value送到Codec的寄存器上。

snd\_soc\_put\_volsw\_2r()作为一个callback函数，用户层要设置某些功能时，如改变Playback Volume：

#amixer cset numid=3,iface=MIXER,name='Playback Volume' 100

到内核层时，会遍历一个节点类型为struct snd\_kcontrol \*的链表，找到kcontrol.id.numid与3相匹配的kctl（这个过程见snd\_ctl\_find\_id()函数），然后调用kctl.put()函数将100写到Playback Volume寄存器中。

当然如果上层没有提供numid，则可根据name找到kcontrol.id.name相匹配的kctl。

注：amixer相关用法见：[http://hi.baidu.com/serial\_story/blog/item/c4e826d82a562f3f32fa1c31.html](http://hi.baidu.com/serial_story/blog/item/c4e826d82a562f3f32fa1c31.html)

从上往下的大致流程：

PS：上层如何设置kctl的numid，可参考[http://blog.csdn.net/cpuwolf/archive/2009/10/17/4686830.aspx](http://blog.csdn.net/cpuwolf/archive/2009/10/17/4686830.aspx)&lt;2011/2/24&gt;

snd\_ctl\_find\_id函数：