11793936bSKuninori Morimoto // SPDX-License-Identifier: GPL-2.0
21793936bSKuninori Morimoto //
31793936bSKuninori Morimoto // soc-card.c
41793936bSKuninori Morimoto //
51793936bSKuninori Morimoto // Copyright (C) 2019 Renesas Electronics Corp.
61793936bSKuninori Morimoto // Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
71793936bSKuninori Morimoto //
8*fb3618f6SRichard Fitzgerald
9*fb3618f6SRichard Fitzgerald #include <linux/lockdep.h>
10*fb3618f6SRichard Fitzgerald #include <linux/rwsem.h>
111793936bSKuninori Morimoto #include <sound/soc.h>
123359e9b6SKuninori Morimoto #include <sound/jack.h>
131793936bSKuninori Morimoto
141793936bSKuninori Morimoto #define soc_card_ret(dai, ret) _soc_card_ret(dai, __func__, ret)
_soc_card_ret(struct snd_soc_card * card,const char * func,int ret)151793936bSKuninori Morimoto static inline int _soc_card_ret(struct snd_soc_card *card,
161793936bSKuninori Morimoto const char *func, int ret)
171793936bSKuninori Morimoto {
181793936bSKuninori Morimoto switch (ret) {
191793936bSKuninori Morimoto case -EPROBE_DEFER:
201793936bSKuninori Morimoto case -ENOTSUPP:
211793936bSKuninori Morimoto case 0:
221793936bSKuninori Morimoto break;
231793936bSKuninori Morimoto default:
241793936bSKuninori Morimoto dev_err(card->dev,
251793936bSKuninori Morimoto "ASoC: error at %s on %s: %d\n",
261793936bSKuninori Morimoto func, card->name, ret);
271793936bSKuninori Morimoto }
281793936bSKuninori Morimoto
291793936bSKuninori Morimoto return ret;
301793936bSKuninori Morimoto }
31209c6cdfSKuninori Morimoto
snd_soc_card_get_kcontrol_locked(struct snd_soc_card * soc_card,const char * name)32*fb3618f6SRichard Fitzgerald struct snd_kcontrol *snd_soc_card_get_kcontrol_locked(struct snd_soc_card *soc_card,
33209c6cdfSKuninori Morimoto const char *name)
34209c6cdfSKuninori Morimoto {
35209c6cdfSKuninori Morimoto struct snd_card *card = soc_card->snd_card;
36209c6cdfSKuninori Morimoto struct snd_kcontrol *kctl;
37209c6cdfSKuninori Morimoto
38*fb3618f6SRichard Fitzgerald /* must be held read or write */
39*fb3618f6SRichard Fitzgerald lockdep_assert_held(&card->controls_rwsem);
40*fb3618f6SRichard Fitzgerald
41209c6cdfSKuninori Morimoto if (unlikely(!name))
42209c6cdfSKuninori Morimoto return NULL;
43209c6cdfSKuninori Morimoto
44209c6cdfSKuninori Morimoto list_for_each_entry(kctl, &card->controls, list)
45209c6cdfSKuninori Morimoto if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name)))
46209c6cdfSKuninori Morimoto return kctl;
47209c6cdfSKuninori Morimoto return NULL;
48209c6cdfSKuninori Morimoto }
49*fb3618f6SRichard Fitzgerald EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol_locked);
50*fb3618f6SRichard Fitzgerald
snd_soc_card_get_kcontrol(struct snd_soc_card * soc_card,const char * name)51*fb3618f6SRichard Fitzgerald struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
52*fb3618f6SRichard Fitzgerald const char *name)
53*fb3618f6SRichard Fitzgerald {
54*fb3618f6SRichard Fitzgerald struct snd_card *card = soc_card->snd_card;
55*fb3618f6SRichard Fitzgerald struct snd_kcontrol *kctl;
56*fb3618f6SRichard Fitzgerald
57*fb3618f6SRichard Fitzgerald down_read(&card->controls_rwsem);
58*fb3618f6SRichard Fitzgerald kctl = snd_soc_card_get_kcontrol_locked(soc_card, name);
59*fb3618f6SRichard Fitzgerald up_read(&card->controls_rwsem);
60*fb3618f6SRichard Fitzgerald
61*fb3618f6SRichard Fitzgerald return kctl;
62*fb3618f6SRichard Fitzgerald }
63209c6cdfSKuninori Morimoto EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol);
643359e9b6SKuninori Morimoto
jack_new(struct snd_soc_card * card,const char * id,int type,struct snd_soc_jack * jack,bool initial_kctl)6519aed2d6SAkihiko Odaki static int jack_new(struct snd_soc_card *card, const char *id, int type,
6619aed2d6SAkihiko Odaki struct snd_soc_jack *jack, bool initial_kctl)
6719aed2d6SAkihiko Odaki {
6819aed2d6SAkihiko Odaki mutex_init(&jack->mutex);
6919aed2d6SAkihiko Odaki jack->card = card;
7019aed2d6SAkihiko Odaki INIT_LIST_HEAD(&jack->pins);
7119aed2d6SAkihiko Odaki INIT_LIST_HEAD(&jack->jack_zones);
7219aed2d6SAkihiko Odaki BLOCKING_INIT_NOTIFIER_HEAD(&jack->notifier);
7319aed2d6SAkihiko Odaki
7419aed2d6SAkihiko Odaki return snd_jack_new(card->snd_card, id, type, &jack->jack, initial_kctl, false);
7519aed2d6SAkihiko Odaki }
7619aed2d6SAkihiko Odaki
773359e9b6SKuninori Morimoto /**
7819aed2d6SAkihiko Odaki * snd_soc_card_jack_new - Create a new jack without pins
7919aed2d6SAkihiko Odaki * @card: ASoC card
8019aed2d6SAkihiko Odaki * @id: an identifying string for this jack
8119aed2d6SAkihiko Odaki * @type: a bitmask of enum snd_jack_type values that can be detected by
8219aed2d6SAkihiko Odaki * this jack
8319aed2d6SAkihiko Odaki * @jack: structure to use for the jack
8419aed2d6SAkihiko Odaki *
8519aed2d6SAkihiko Odaki * Creates a new jack object without pins. If adding pins later,
8619aed2d6SAkihiko Odaki * snd_soc_card_jack_new_pins() should be used instead with 0 as num_pins
8719aed2d6SAkihiko Odaki * argument.
8819aed2d6SAkihiko Odaki *
8919aed2d6SAkihiko Odaki * Returns zero if successful, or a negative error code on failure.
9019aed2d6SAkihiko Odaki * On success jack will be initialised.
9119aed2d6SAkihiko Odaki */
snd_soc_card_jack_new(struct snd_soc_card * card,const char * id,int type,struct snd_soc_jack * jack)9219aed2d6SAkihiko Odaki int snd_soc_card_jack_new(struct snd_soc_card *card, const char *id, int type,
9319aed2d6SAkihiko Odaki struct snd_soc_jack *jack)
9419aed2d6SAkihiko Odaki {
9519aed2d6SAkihiko Odaki return soc_card_ret(card, jack_new(card, id, type, jack, true));
9619aed2d6SAkihiko Odaki }
9719aed2d6SAkihiko Odaki EXPORT_SYMBOL_GPL(snd_soc_card_jack_new);
9819aed2d6SAkihiko Odaki
9919aed2d6SAkihiko Odaki /**
10019aed2d6SAkihiko Odaki * snd_soc_card_jack_new_pins - Create a new jack with pins
1013359e9b6SKuninori Morimoto * @card: ASoC card
1023359e9b6SKuninori Morimoto * @id: an identifying string for this jack
1033359e9b6SKuninori Morimoto * @type: a bitmask of enum snd_jack_type values that can be detected by
1043359e9b6SKuninori Morimoto * this jack
1053359e9b6SKuninori Morimoto * @jack: structure to use for the jack
1063359e9b6SKuninori Morimoto * @pins: Array of jack pins to be added to the jack or NULL
1073359e9b6SKuninori Morimoto * @num_pins: Number of elements in the @pins array
1083359e9b6SKuninori Morimoto *
10919aed2d6SAkihiko Odaki * Creates a new jack object with pins. If not adding pins,
11019aed2d6SAkihiko Odaki * snd_soc_card_jack_new() should be used instead.
1113359e9b6SKuninori Morimoto *
1123359e9b6SKuninori Morimoto * Returns zero if successful, or a negative error code on failure.
1133359e9b6SKuninori Morimoto * On success jack will be initialised.
1143359e9b6SKuninori Morimoto */
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)11519aed2d6SAkihiko Odaki int snd_soc_card_jack_new_pins(struct snd_soc_card *card, const char *id,
11619aed2d6SAkihiko Odaki int type, struct snd_soc_jack *jack,
11719aed2d6SAkihiko Odaki struct snd_soc_jack_pin *pins,
11819aed2d6SAkihiko Odaki unsigned int num_pins)
1193359e9b6SKuninori Morimoto {
1203359e9b6SKuninori Morimoto int ret;
1213359e9b6SKuninori Morimoto
12219aed2d6SAkihiko Odaki ret = jack_new(card, id, type, jack, false);
1233359e9b6SKuninori Morimoto if (ret)
1243359e9b6SKuninori Morimoto goto end;
1253359e9b6SKuninori Morimoto
1263359e9b6SKuninori Morimoto if (num_pins)
1273359e9b6SKuninori Morimoto ret = snd_soc_jack_add_pins(jack, num_pins, pins);
1283359e9b6SKuninori Morimoto end:
1293359e9b6SKuninori Morimoto return soc_card_ret(card, ret);
1303359e9b6SKuninori Morimoto }
13119aed2d6SAkihiko Odaki EXPORT_SYMBOL_GPL(snd_soc_card_jack_new_pins);
132130dc08cSKuninori Morimoto
snd_soc_card_suspend_pre(struct snd_soc_card * card)133130dc08cSKuninori Morimoto int snd_soc_card_suspend_pre(struct snd_soc_card *card)
134130dc08cSKuninori Morimoto {
135130dc08cSKuninori Morimoto int ret = 0;
136130dc08cSKuninori Morimoto
137130dc08cSKuninori Morimoto if (card->suspend_pre)
138130dc08cSKuninori Morimoto ret = card->suspend_pre(card);
139130dc08cSKuninori Morimoto
140130dc08cSKuninori Morimoto return soc_card_ret(card, ret);
141130dc08cSKuninori Morimoto }
142d17b60b2SKuninori Morimoto
snd_soc_card_suspend_post(struct snd_soc_card * card)143d17b60b2SKuninori Morimoto int snd_soc_card_suspend_post(struct snd_soc_card *card)
144d17b60b2SKuninori Morimoto {
145d17b60b2SKuninori Morimoto int ret = 0;
146d17b60b2SKuninori Morimoto
147d17b60b2SKuninori Morimoto if (card->suspend_post)
148d17b60b2SKuninori Morimoto ret = card->suspend_post(card);
149d17b60b2SKuninori Morimoto
150d17b60b2SKuninori Morimoto return soc_card_ret(card, ret);
151d17b60b2SKuninori Morimoto }
152934c752cSKuninori Morimoto
snd_soc_card_resume_pre(struct snd_soc_card * card)153934c752cSKuninori Morimoto int snd_soc_card_resume_pre(struct snd_soc_card *card)
154934c752cSKuninori Morimoto {
155934c752cSKuninori Morimoto int ret = 0;
156934c752cSKuninori Morimoto
157934c752cSKuninori Morimoto if (card->resume_pre)
158934c752cSKuninori Morimoto ret = card->resume_pre(card);
159934c752cSKuninori Morimoto
160934c752cSKuninori Morimoto return soc_card_ret(card, ret);
161934c752cSKuninori Morimoto }
162739443d1SKuninori Morimoto
snd_soc_card_resume_post(struct snd_soc_card * card)163739443d1SKuninori Morimoto int snd_soc_card_resume_post(struct snd_soc_card *card)
164739443d1SKuninori Morimoto {
165739443d1SKuninori Morimoto int ret = 0;
166739443d1SKuninori Morimoto
167739443d1SKuninori Morimoto if (card->resume_post)
168739443d1SKuninori Morimoto ret = card->resume_post(card);
169739443d1SKuninori Morimoto
170739443d1SKuninori Morimoto return soc_card_ret(card, ret);
171739443d1SKuninori Morimoto }
17273de4b02SKuninori Morimoto
snd_soc_card_probe(struct snd_soc_card * card)17373de4b02SKuninori Morimoto int snd_soc_card_probe(struct snd_soc_card *card)
17473de4b02SKuninori Morimoto {
17573de4b02SKuninori Morimoto if (card->probe) {
17673de4b02SKuninori Morimoto int ret = card->probe(card);
17773de4b02SKuninori Morimoto
17873de4b02SKuninori Morimoto if (ret < 0)
17973de4b02SKuninori Morimoto return soc_card_ret(card, ret);
18073de4b02SKuninori Morimoto
18173de4b02SKuninori Morimoto /*
18273de4b02SKuninori Morimoto * It has "card->probe" and "card->late_probe" callbacks.
18373de4b02SKuninori Morimoto * So, set "probed" flag here, because it needs to care
18473de4b02SKuninori Morimoto * about "late_probe".
18573de4b02SKuninori Morimoto *
18673de4b02SKuninori Morimoto * see
18773de4b02SKuninori Morimoto * snd_soc_bind_card()
18873de4b02SKuninori Morimoto * snd_soc_card_late_probe()
18973de4b02SKuninori Morimoto */
19073de4b02SKuninori Morimoto card->probed = 1;
19173de4b02SKuninori Morimoto }
19273de4b02SKuninori Morimoto
19373de4b02SKuninori Morimoto return 0;
19473de4b02SKuninori Morimoto }
1955c0eac03SKuninori Morimoto
snd_soc_card_late_probe(struct snd_soc_card * card)1965c0eac03SKuninori Morimoto int snd_soc_card_late_probe(struct snd_soc_card *card)
1975c0eac03SKuninori Morimoto {
1985c0eac03SKuninori Morimoto if (card->late_probe) {
1995c0eac03SKuninori Morimoto int ret = card->late_probe(card);
2005c0eac03SKuninori Morimoto
2015c0eac03SKuninori Morimoto if (ret < 0)
2025c0eac03SKuninori Morimoto return soc_card_ret(card, ret);
2035c0eac03SKuninori Morimoto }
2045c0eac03SKuninori Morimoto
2055c0eac03SKuninori Morimoto /*
2065c0eac03SKuninori Morimoto * It has "card->probe" and "card->late_probe" callbacks,
2075c0eac03SKuninori Morimoto * and "late_probe" callback is called after "probe".
2085c0eac03SKuninori Morimoto * This means, we can set "card->probed" flag afer "late_probe"
2095c0eac03SKuninori Morimoto * for all cases.
2105c0eac03SKuninori Morimoto *
2115c0eac03SKuninori Morimoto * see
2125c0eac03SKuninori Morimoto * snd_soc_bind_card()
2135c0eac03SKuninori Morimoto * snd_soc_card_probe()
2145c0eac03SKuninori Morimoto */
2155c0eac03SKuninori Morimoto card->probed = 1;
2165c0eac03SKuninori Morimoto
2175c0eac03SKuninori Morimoto return 0;
2185c0eac03SKuninori Morimoto }
219b0275d95SKuninori Morimoto
snd_soc_card_fixup_controls(struct snd_soc_card * card)220df4d27b1SMartin Povišer void snd_soc_card_fixup_controls(struct snd_soc_card *card)
221df4d27b1SMartin Povišer {
222df4d27b1SMartin Povišer if (card->fixup_controls)
223df4d27b1SMartin Povišer card->fixup_controls(card);
224df4d27b1SMartin Povišer }
225df4d27b1SMartin Povišer
snd_soc_card_remove(struct snd_soc_card * card)226b0275d95SKuninori Morimoto int snd_soc_card_remove(struct snd_soc_card *card)
227b0275d95SKuninori Morimoto {
228b0275d95SKuninori Morimoto int ret = 0;
229b0275d95SKuninori Morimoto
230b0275d95SKuninori Morimoto if (card->probed &&
231b0275d95SKuninori Morimoto card->remove)
232b0275d95SKuninori Morimoto ret = card->remove(card);
233b0275d95SKuninori Morimoto
234b0275d95SKuninori Morimoto card->probed = 0;
235b0275d95SKuninori Morimoto
236b0275d95SKuninori Morimoto return soc_card_ret(card, ret);
237b0275d95SKuninori Morimoto }
23839caefdaSKuninori Morimoto
snd_soc_card_set_bias_level(struct snd_soc_card * card,struct snd_soc_dapm_context * dapm,enum snd_soc_bias_level level)23939caefdaSKuninori Morimoto int snd_soc_card_set_bias_level(struct snd_soc_card *card,
24039caefdaSKuninori Morimoto struct snd_soc_dapm_context *dapm,
24139caefdaSKuninori Morimoto enum snd_soc_bias_level level)
24239caefdaSKuninori Morimoto {
24339caefdaSKuninori Morimoto int ret = 0;
24439caefdaSKuninori Morimoto
24539caefdaSKuninori Morimoto if (card && card->set_bias_level)
24639caefdaSKuninori Morimoto ret = card->set_bias_level(card, dapm, level);
24739caefdaSKuninori Morimoto
24839caefdaSKuninori Morimoto return soc_card_ret(card, ret);
24939caefdaSKuninori Morimoto }
250d41278eaSKuninori Morimoto
snd_soc_card_set_bias_level_post(struct snd_soc_card * card,struct snd_soc_dapm_context * dapm,enum snd_soc_bias_level level)251d41278eaSKuninori Morimoto int snd_soc_card_set_bias_level_post(struct snd_soc_card *card,
252d41278eaSKuninori Morimoto struct snd_soc_dapm_context *dapm,
253d41278eaSKuninori Morimoto enum snd_soc_bias_level level)
254d41278eaSKuninori Morimoto {
255d41278eaSKuninori Morimoto int ret = 0;
256d41278eaSKuninori Morimoto
257d41278eaSKuninori Morimoto if (card && card->set_bias_level_post)
258d41278eaSKuninori Morimoto ret = card->set_bias_level_post(card, dapm, level);
259d41278eaSKuninori Morimoto
260d41278eaSKuninori Morimoto return soc_card_ret(card, ret);
261d41278eaSKuninori Morimoto }
262cbc7a6b5SKuninori Morimoto
snd_soc_card_add_dai_link(struct snd_soc_card * card,struct snd_soc_dai_link * dai_link)263cbc7a6b5SKuninori Morimoto int snd_soc_card_add_dai_link(struct snd_soc_card *card,
264cbc7a6b5SKuninori Morimoto struct snd_soc_dai_link *dai_link)
265cbc7a6b5SKuninori Morimoto {
266cbc7a6b5SKuninori Morimoto int ret = 0;
267cbc7a6b5SKuninori Morimoto
268cbc7a6b5SKuninori Morimoto if (card->add_dai_link)
269cbc7a6b5SKuninori Morimoto ret = card->add_dai_link(card, dai_link);
270cbc7a6b5SKuninori Morimoto
271cbc7a6b5SKuninori Morimoto return soc_card_ret(card, ret);
272cbc7a6b5SKuninori Morimoto }
273cbc7a6b5SKuninori Morimoto EXPORT_SYMBOL_GPL(snd_soc_card_add_dai_link);
274fcbbcc32SKuninori Morimoto
snd_soc_card_remove_dai_link(struct snd_soc_card * card,struct snd_soc_dai_link * dai_link)275fcbbcc32SKuninori Morimoto void snd_soc_card_remove_dai_link(struct snd_soc_card *card,
276fcbbcc32SKuninori Morimoto struct snd_soc_dai_link *dai_link)
277fcbbcc32SKuninori Morimoto {
278fcbbcc32SKuninori Morimoto if (card->remove_dai_link)
279fcbbcc32SKuninori Morimoto card->remove_dai_link(card, dai_link);
280fcbbcc32SKuninori Morimoto }
281fcbbcc32SKuninori Morimoto EXPORT_SYMBOL_GPL(snd_soc_card_remove_dai_link);
282