Quelle  soc-card.c   Sprache: C

// SPDX-License-Identifier: GPL-2.0
//
// soc-card.c
//
// Copyright (C) 2019 Renesas Electronics Corp.
// Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
//

#include <linux/lockdep.h>
#include <linux/rwsem.h>
#include <sound/soc.h>
#include <sound/jack.h>

#define soc_card_ret(dai, ret) _soc_card_ret(dai, __func__, ret)
static inline int _soc_card_ret(struct snd_soc_card *card,
    const char *func, int ret)
{
 return snd_soc_ret(card->dev, ret,
      "at %s() on %s\n", func, card->name);
}

struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
            const char *name)
{
 if (unlikely(!name))
  return NULL;

 return snd_ctl_find_id_mixer(soc_card->snd_card, name);
}
EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol);

static int jack_new(struct snd_soc_card *card, const char *id, int type,
      struct snd_soc_jack *jack, bool initial_kctl)
{
 mutex_init(&jack->mutex);
 jack->card = card;
 INIT_LIST_HEAD(&jack->pins);
 INIT_LIST_HEAD(&jack->jack_zones);
 BLOCKING_INIT_NOTIFIER_HEAD(&jack->notifier);

 return snd_jack_new(card->snd_card, id, type, &jack->jack, initial_kctl, false);
}

/**
 * snd_soc_card_jack_new - Create a new jack without pins
 * @card:  ASoC card
 * @id:    an identifying string for this jack
 * @type:  a bitmask of enum snd_jack_type values that can be detected by
 *         this jack
 * @jack:  structure to use for the jack
 *
 * Creates a new jack object without pins. If adding pins later,
 * snd_soc_card_jack_new_pins() should be used instead with 0 as num_pins
 * argument.
 *
 * Returns zero if successful, or a negative error code on failure.
 * On success jack will be initialised.
 */
int snd_soc_card_jack_new(struct snd_soc_card *card, const char *id, int type,
     struct snd_soc_jack *jack)
{
 return soc_card_ret(card, jack_new(card, id, type, jack, true));
}
EXPORT_SYMBOL_GPL(snd_soc_card_jack_new);

/**
 * snd_soc_card_jack_new_pins - Create a new jack with pins
 * @card:  ASoC card
 * @id:    an identifying string for this jack
 * @type:  a bitmask of enum snd_jack_type values that can be detected by
 *         this jack
 * @jack:  structure to use for the jack
 * @pins:  Array of jack pins to be added to the jack or NULL
 * @num_pins: Number of elements in the @pins array
 *
 * Creates a new jack object with pins. If not adding pins,
 * snd_soc_card_jack_new() should be used instead.
 *
 * Returns zero if successful, or a negative error code on failure.
 * On success jack will be initialised.
 */
int snd_soc_card_jack_new_pins(struct snd_soc_card *card, const char *id,
          int type, struct snd_soc_jack *jack,
          struct snd_soc_jack_pin *pins,
          unsigned int num_pins)
{
 int ret;

 ret = jack_new(card, id, type, jack, false);
 if (ret)
  goto end;

 if (num_pins)
  ret = snd_soc_jack_add_pins(jack, num_pins, pins);
end:
 return soc_card_ret(card, ret);
}
EXPORT_SYMBOL_GPL(snd_soc_card_jack_new_pins);

int snd_soc_card_suspend_pre(struct snd_soc_card *card)
{
 int ret = 0;

 if (card->suspend_pre)
  ret = card->suspend_pre(card);

 return soc_card_ret(card, ret);
}

int snd_soc_card_suspend_post(struct snd_soc_card *card)
{
 int ret = 0;

 if (card->suspend_post)
  ret = card->suspend_post(card);

 return soc_card_ret(card, ret);
}

int snd_soc_card_resume_pre(struct snd_soc_card *card)
{
 int ret = 0;

 if (card->resume_pre)
  ret = card->resume_pre(card);

 return soc_card_ret(card, ret);
}

int snd_soc_card_resume_post(struct snd_soc_card *card)
{
 int ret = 0;

 if (card->resume_post)
  ret = card->resume_post(card);

 return soc_card_ret(card, ret);
}

int snd_soc_card_probe(struct snd_soc_card *card)
{
 if (card->probe) {
  int ret = card->probe(card);

  if (ret < 0)
   return soc_card_ret(card, ret);

  /*
 * It has "card->probe" and "card->late_probe" callbacks.
 * So, set "probed" flag here, because it needs to care
 * about "late_probe".
 *
 * see
 * snd_soc_bind_card()
 * snd_soc_card_late_probe()
 */
  card->probed = 1;
 }

 return 0;
}

int snd_soc_card_late_probe(struct snd_soc_card *card)
{
 if (card->late_probe) {
  int ret = card->late_probe(card);

  if (ret < 0)
   return soc_card_ret(card, ret);
 }

 /*
 * It has "card->probe" and "card->late_probe" callbacks,
 * and "late_probe" callback is called after "probe".
 * This means, we can set "card->probed" flag afer "late_probe"
 * for all cases.
 *
 * see
 * snd_soc_bind_card()
 * snd_soc_card_probe()
 */
 card->probed = 1;

 return 0;
}

void snd_soc_card_fixup_controls(struct snd_soc_card *card)
{
 if (card->fixup_controls)
  card->fixup_controls(card);
}

int snd_soc_card_remove(struct snd_soc_card *card)
{
 int ret = 0;

 if (card->probed &&
     card->remove)
  ret = card->remove(card);

 card->probed = 0;

 return soc_card_ret(card, ret);
}

int snd_soc_card_set_bias_level(struct snd_soc_card *card,
    struct snd_soc_dapm_context *dapm,
    enum snd_soc_bias_level level)
{
 int ret = 0;

 if (card->set_bias_level)
  ret = card->set_bias_level(card, dapm, level);

 return soc_card_ret(card, ret);
}

int snd_soc_card_set_bias_level_post(struct snd_soc_card *card,
         struct snd_soc_dapm_context *dapm,
         enum snd_soc_bias_level level)
{
 int ret = 0;

 if (card->set_bias_level_post)
  ret = card->set_bias_level_post(card, dapm, level);

 return soc_card_ret(card, ret);
}

int snd_soc_card_add_dai_link(struct snd_soc_card *card,
         struct snd_soc_dai_link *dai_link)
{
 int ret = 0;

 if (card->add_dai_link)
  ret = card->add_dai_link(card, dai_link);

 return soc_card_ret(card, ret);
}
EXPORT_SYMBOL_GPL(snd_soc_card_add_dai_link);

void snd_soc_card_remove_dai_link(struct snd_soc_card *card,
      struct snd_soc_dai_link *dai_link)
{
 if (card->remove_dai_link)
  card->remove_dai_link(card, dai_link);
}
EXPORT_SYMBOL_GPL(snd_soc_card_remove_dai_link);