コグノスケ

kcontrolの宣言とSOC_DOUBLEの実装

//linux-4.4/sound/soc/codecs/tas571x.c

static const struct snd_kcontrol_new tas5717_controls[] = {
...
        SOC_DOUBLE("Speaker Switch",
                   TAS571X_SOFT_MUTE_REG,
                   TAS571X_SOFT_MUTE_CH1_SHIFT, TAS571X_SOFT_MUTE_CH2_SHIFT,
                   1, 1),


//linux-4.4/include/sound/soc.h

#define SOC_DOUBLE(xname, reg, shift_left, shift_right, max, invert) \
{       .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\
        .info = snd_soc_info_volsw, .get = snd_soc_get_volsw, \    //★たぶんこれ使って読んでるんだろう★
        .put = snd_soc_put_volsw, \
        .private_value = SOC_DOUBLE_VALUE(reg, shift_left, shift_right, \
                                          max, invert, 0) }


//linux-4.4/sound/soc/soc-ops.c

int snd_soc_get_volsw(struct snd_kcontrol *kcontrol,
        struct snd_ctl_elem_value *ucontrol)
{
...
        ret = snd_soc_read_signed(component, reg, mask, shift, sign_bit, &val);
        if (ret)
                return ret;
...


//linux-4.4/sound/soc/soc-ops.c

static int snd_soc_read_signed(struct snd_soc_component *component,
        unsigned int reg, unsigned int mask, unsigned int shift,
        unsigned int sign_bit, int *signed_val)
{
...
        ret = snd_soc_component_read(component, reg, &val);
        if (ret < 0)
                return ret;


//linux-4.4/sound/soc/soc-io.c

int snd_soc_component_read(struct snd_soc_component *component,
        unsigned int reg, unsigned int *val)
{
        int ret;

        if (component->regmap)
                ret = regmap_read(component->regmap, reg, val);    //★regmapで読み出すか★
        else if (component->read)
                ret = component->read(component, reg, val);    //★regmapが無くて、独自のレジスタアクセス関数があればそちらを使う★
        else
                ret = -EIO;    //★どちらもなければエラー★

        return ret;
}

snd_soc_register_codec

//linux-4.4/sound/soc/soc-core.c

int snd_soc_register_codec(struct device *dev,
                           const struct snd_soc_codec_driver *codec_drv,
                           struct snd_soc_dai_driver *dai_drv,
                           int num_dai)
{
...
        struct snd_soc_codec *codec;
...
        codec = kzalloc(sizeof(struct snd_soc_codec), GFP_KERNEL);
        if (codec == NULL)
                return -ENOMEM;

        codec->component.codec = codec;

        ret = snd_soc_component_initialize(&codec->component,    //★注目その2★
                        &codec_drv->component_driver, dev);
        if (ret)
                goto err_free;
...
        mutex_lock(&client_mutex);
        snd_soc_component_add_unlocked(&codec->component);    //★注目その1★
        list_add(&codec->list, &codec_list);
        mutex_unlock(&client_mutex);
...

component->regmapが設定されるまで

//linux-4.4/sound/soc/soc-core.c

static void snd_soc_component_add_unlocked(struct snd_soc_component *component)
{
        if (!component->write && !component->read) {
                if (!component->regmap)
                        component->regmap = dev_get_regmap(component->dev, NULL);
...


//linux-4.4/drivers/base/regmap/regmap.c

struct regmap *dev_get_regmap(struct device *dev, const char *name)
{
        struct regmap **r = devres_find(dev, dev_get_regmap_release,
                                        dev_get_regmap_match, (void *)name);
...


//linux-4.4/drivers/base/regmap/regmap.c

static int dev_get_regmap_match(struct device *dev, void *res, void *data)
{
        struct regmap **r = res;
...
        /* If the user didn't specify a name match any */
        if (data)
                return (*r)->name == data;
        else
                return 1;
...


//linux-4.4/drivers/base/devres.c

void * devres_find(struct device *dev, dr_release_t release,
                   dr_match_t match, void *match_data)
{
        struct devres *dr;
...
        dr = find_dr(dev, release, match, match_data);
...


//linux-4.4/drivers/base/devres.c

static struct devres *find_dr(struct device *dev, dr_release_t release,
                              dr_match_t match, void *match_data)
{
        struct devres_node *node;

        list_for_each_entry_reverse(node, &dev->devres_head, entry) {
                struct devres *dr = container_of(node, struct devres, node);

                if (node->release != release)
                        continue;
                //★今回はmatchにdev_get_regmap_match() を渡しています★
                //★またmatch_dataにはNULLを渡しています★
                //★dev_get_regmap_match() の第3引数がNULLの場合、最初に見つけたregmapにヒットします★
                if (match && !match(dev, dr->data, match_data))
                        continue;
                return dr;
        }

        return NULL;
}

component->regmapが設定されるまで

//linux-4.4/sound/soc/soc-core.c

static int snd_soc_component_initialize(struct snd_soc_component *component,
        const struct snd_soc_component_driver *driver, struct device *dev)
{
...
        component->dev = dev;    //★これです★
        component->driver = driver;
        component->probe = component->driver->probe;
        component->remove = component->driver->remove;

TAS5086再び

//linux-4.4/sound/soc/codecs/tas5086.c

static int tas5086_i2c_probe(struct i2c_client *i2c,
                             const struct i2c_device_id *id)
{
...
        priv->regmap = devm_regmap_init(dev, NULL, i2c, &tas5086_regmap);    //★もしかしてこれ？★
        if (IS_ERR(priv->regmap)) {
                ret = PTR_ERR(priv->regmap);
                dev_err(&i2c->dev, "Failed to create regmap: %d\n", ret);
                return ret;
        }
...
        if (ret == 0)
                ret = snd_soc_register_codec(&i2c->dev, &soc_codec_dev_tas5086,    //★snd_soc_codec_driverのポインタをここに渡している★
                                             &tas5086_dai, 1);

        return ret;
}

デバイスのリソースリストとregmapの関係

//linux-4.4/include/linux/regmap.h

#define devm_regmap_init(dev, bus, bus_context, config)                 \
        __regmap_lockdep_wrapper(__devm_regmap_init, #config,           \
                                dev, bus, bus_context, config)
//★__regmap_lockdep_wrapper() はロックを取って __devm_regmap_init() を呼ぶマクロ★


//linux-4.4/drivers/base/regmap/regmap.c

struct regmap *__devm_regmap_init(struct device *dev,
                                  const struct regmap_bus *bus,
                                  void *bus_context,
                                  const struct regmap_config *config,
                                  struct lock_class_key *lock_key,
                                  const char *lock_name)
{
        struct regmap **ptr, *regmap;

        ptr = devres_alloc(devm_regmap_release, sizeof(*ptr), GFP_KERNEL);
        if (!ptr)
                return ERR_PTR(-ENOMEM);

        //★regmap_init() も結局 __regmap_init() を呼ぶだけなのに何が違う？★
        regmap = __regmap_init(dev, bus, bus_context, config,
                               lock_key, lock_name);
        if (!IS_ERR(regmap)) {
                *ptr = regmap;
                devres_add(dev, ptr);    //★もしかしてこれ？★
        } else {
                devres_free(ptr);
        }

        return regmap;
}


//linux-4.4/drivers/base/devres.c

void devres_add(struct device *dev, void *res)
{
        struct devres *dr = container_of(res, struct devres, data);
        unsigned long flags;

        spin_lock_irqsave(&dev->devres_lock, flags);
        add_dr(dev, &dr->node);
        spin_unlock_irqrestore(&dev->devres_lock, flags);
}


//linux-4.4/drivers/base/devres.c

static void add_dr(struct device *dev, struct devres_node *node)
{
        devres_log(dev, node, "ADD");
        BUG_ON(!list_empty(&node->entry));
        list_add_tail(&node->entry, &dev->devres_head);    //★ここでリストに追加している！★
}

kcontrolの宣言

//from linux-4.4/sound/soc/codecs/tas571x.c

static const struct snd_kcontrol_new tas5711_controls[] = {
...
        SOC_DOUBLE("Speaker Switch",
                   TAS571X_SOFT_MUTE_REG,
                   TAS571X_SOFT_MUTE_CH1_SHIFT, TAS571X_SOFT_MUTE_CH2_SHIFT,
                   1, 1),
};

kcontrolの宣言

//from linux-4.4/sound/soc/codecs/tas5086.c

static const struct snd_kcontrol_new tas5086_controls[] = {
        SOC_SINGLE_TLV("Master Playback Volume", TAS5086_MASTER_VOL,
...

static struct snd_soc_codec_driver soc_codec_dev_tas5086 = {
        .probe                  = tas5086_probe,
        .remove                 = tas5086_remove,
        .suspend                = tas5086_soc_suspend,
        .resume                 = tas5086_soc_resume,
        .controls               = tas5086_controls,    //★snd_kcontrol_new配列のポインタをここに渡している★
        .num_controls           = ARRAY_SIZE(tas5086_controls),
        .dapm_widgets           = tas5086_dapm_widgets,
        .num_dapm_widgets       = ARRAY_SIZE(tas5086_dapm_widgets),
        .dapm_routes            = tas5086_dapm_routes,
        .num_dapm_routes        = ARRAY_SIZE(tas5086_dapm_routes),
};

static int tas5086_i2c_probe(struct i2c_client *i2c,
                             const struct i2c_device_id *id)
{
...
        if (ret == 0)
                ret = snd_soc_register_codec(&i2c->dev, &soc_codec_dev_tas5086,    //★snd_soc_codec_driverのポインタをここに渡している★
                                             &tas5086_dai, 1);

        return ret;
}

CPU                 : GNU yes 8.23 : GNU yes 8.26 : 自家製yes（バッファ16KB）
AMD A10 7800        : 123MiB/s     : 2.8GiB/s     : 3.2GiB/s
Intel Pentium J4205 : 40MiB/s      : 1.9GiB/s     : 2GiB/s