xref: /OK3568_Linux_fs/kernel/sound/soc/soc-card.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun //
3*4882a593Smuzhiyun // soc-card.c
4*4882a593Smuzhiyun //
5*4882a593Smuzhiyun // Copyright (C) 2019 Renesas Electronics Corp.
6*4882a593Smuzhiyun // Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
7*4882a593Smuzhiyun //
8*4882a593Smuzhiyun #include <sound/soc.h>
9*4882a593Smuzhiyun #include <sound/jack.h>
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun #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)12*4882a593Smuzhiyun static inline int _soc_card_ret(struct snd_soc_card *card,
13*4882a593Smuzhiyun 				const char *func, int ret)
14*4882a593Smuzhiyun {
15*4882a593Smuzhiyun 	switch (ret) {
16*4882a593Smuzhiyun 	case -EPROBE_DEFER:
17*4882a593Smuzhiyun 	case -ENOTSUPP:
18*4882a593Smuzhiyun 	case 0:
19*4882a593Smuzhiyun 		break;
20*4882a593Smuzhiyun 	default:
21*4882a593Smuzhiyun 		dev_err(card->dev,
22*4882a593Smuzhiyun 			"ASoC: error at %s on %s: %d\n",
23*4882a593Smuzhiyun 			func, card->name, ret);
24*4882a593Smuzhiyun 	}
25*4882a593Smuzhiyun 
26*4882a593Smuzhiyun 	return ret;
27*4882a593Smuzhiyun }
28*4882a593Smuzhiyun 
snd_soc_card_get_kcontrol(struct snd_soc_card * soc_card,const char * name)29*4882a593Smuzhiyun struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
30*4882a593Smuzhiyun 					       const char *name)
31*4882a593Smuzhiyun {
32*4882a593Smuzhiyun 	struct snd_card *card = soc_card->snd_card;
33*4882a593Smuzhiyun 	struct snd_kcontrol *kctl;
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun 	if (unlikely(!name))
36*4882a593Smuzhiyun 		return NULL;
37*4882a593Smuzhiyun 
38*4882a593Smuzhiyun 	list_for_each_entry(kctl, &card->controls, list)
39*4882a593Smuzhiyun 		if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name)))
40*4882a593Smuzhiyun 			return kctl;
41*4882a593Smuzhiyun 	return NULL;
42*4882a593Smuzhiyun }
43*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol);
44*4882a593Smuzhiyun 
45*4882a593Smuzhiyun /**
46*4882a593Smuzhiyun  * snd_soc_card_jack_new - Create a new jack
47*4882a593Smuzhiyun  * @card:  ASoC card
48*4882a593Smuzhiyun  * @id:    an identifying string for this jack
49*4882a593Smuzhiyun  * @type:  a bitmask of enum snd_jack_type values that can be detected by
50*4882a593Smuzhiyun  *         this jack
51*4882a593Smuzhiyun  * @jack:  structure to use for the jack
52*4882a593Smuzhiyun  * @pins:  Array of jack pins to be added to the jack or NULL
53*4882a593Smuzhiyun  * @num_pins: Number of elements in the @pins array
54*4882a593Smuzhiyun  *
55*4882a593Smuzhiyun  * Creates a new jack object.
56*4882a593Smuzhiyun  *
57*4882a593Smuzhiyun  * Returns zero if successful, or a negative error code on failure.
58*4882a593Smuzhiyun  * On success jack will be initialised.
59*4882a593Smuzhiyun  */
snd_soc_card_jack_new(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)60*4882a593Smuzhiyun int snd_soc_card_jack_new(struct snd_soc_card *card, const char *id, int type,
61*4882a593Smuzhiyun 			  struct snd_soc_jack *jack,
62*4882a593Smuzhiyun 			  struct snd_soc_jack_pin *pins, unsigned int num_pins)
63*4882a593Smuzhiyun {
64*4882a593Smuzhiyun 	int ret;
65*4882a593Smuzhiyun 
66*4882a593Smuzhiyun 	mutex_init(&jack->mutex);
67*4882a593Smuzhiyun 	jack->card = card;
68*4882a593Smuzhiyun 	INIT_LIST_HEAD(&jack->pins);
69*4882a593Smuzhiyun 	INIT_LIST_HEAD(&jack->jack_zones);
70*4882a593Smuzhiyun 	BLOCKING_INIT_NOTIFIER_HEAD(&jack->notifier);
71*4882a593Smuzhiyun 
72*4882a593Smuzhiyun 	ret = snd_jack_new(card->snd_card, id, type, &jack->jack, false, false);
73*4882a593Smuzhiyun 	if (ret)
74*4882a593Smuzhiyun 		goto end;
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun 	if (num_pins)
77*4882a593Smuzhiyun 		ret = snd_soc_jack_add_pins(jack, num_pins, pins);
78*4882a593Smuzhiyun end:
79*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
80*4882a593Smuzhiyun }
81*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(snd_soc_card_jack_new);
82*4882a593Smuzhiyun 
snd_soc_card_suspend_pre(struct snd_soc_card * card)83*4882a593Smuzhiyun int snd_soc_card_suspend_pre(struct snd_soc_card *card)
84*4882a593Smuzhiyun {
85*4882a593Smuzhiyun 	int ret = 0;
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun 	if (card->suspend_pre)
88*4882a593Smuzhiyun 		ret = card->suspend_pre(card);
89*4882a593Smuzhiyun 
90*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
91*4882a593Smuzhiyun }
92*4882a593Smuzhiyun 
snd_soc_card_suspend_post(struct snd_soc_card * card)93*4882a593Smuzhiyun int snd_soc_card_suspend_post(struct snd_soc_card *card)
94*4882a593Smuzhiyun {
95*4882a593Smuzhiyun 	int ret = 0;
96*4882a593Smuzhiyun 
97*4882a593Smuzhiyun 	if (card->suspend_post)
98*4882a593Smuzhiyun 		ret = card->suspend_post(card);
99*4882a593Smuzhiyun 
100*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
101*4882a593Smuzhiyun }
102*4882a593Smuzhiyun 
snd_soc_card_resume_pre(struct snd_soc_card * card)103*4882a593Smuzhiyun int snd_soc_card_resume_pre(struct snd_soc_card *card)
104*4882a593Smuzhiyun {
105*4882a593Smuzhiyun 	int ret = 0;
106*4882a593Smuzhiyun 
107*4882a593Smuzhiyun 	if (card->resume_pre)
108*4882a593Smuzhiyun 		ret = card->resume_pre(card);
109*4882a593Smuzhiyun 
110*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
111*4882a593Smuzhiyun }
112*4882a593Smuzhiyun 
snd_soc_card_resume_post(struct snd_soc_card * card)113*4882a593Smuzhiyun int snd_soc_card_resume_post(struct snd_soc_card *card)
114*4882a593Smuzhiyun {
115*4882a593Smuzhiyun 	int ret = 0;
116*4882a593Smuzhiyun 
117*4882a593Smuzhiyun 	if (card->resume_post)
118*4882a593Smuzhiyun 		ret = card->resume_post(card);
119*4882a593Smuzhiyun 
120*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
121*4882a593Smuzhiyun }
122*4882a593Smuzhiyun 
snd_soc_card_probe(struct snd_soc_card * card)123*4882a593Smuzhiyun int snd_soc_card_probe(struct snd_soc_card *card)
124*4882a593Smuzhiyun {
125*4882a593Smuzhiyun 	if (card->probe) {
126*4882a593Smuzhiyun 		int ret = card->probe(card);
127*4882a593Smuzhiyun 
128*4882a593Smuzhiyun 		if (ret < 0)
129*4882a593Smuzhiyun 			return soc_card_ret(card, ret);
130*4882a593Smuzhiyun 
131*4882a593Smuzhiyun 		/*
132*4882a593Smuzhiyun 		 * It has "card->probe" and "card->late_probe" callbacks.
133*4882a593Smuzhiyun 		 * So, set "probed" flag here, because it needs to care
134*4882a593Smuzhiyun 		 * about "late_probe".
135*4882a593Smuzhiyun 		 *
136*4882a593Smuzhiyun 		 * see
137*4882a593Smuzhiyun 		 *	snd_soc_bind_card()
138*4882a593Smuzhiyun 		 *	snd_soc_card_late_probe()
139*4882a593Smuzhiyun 		 */
140*4882a593Smuzhiyun 		card->probed = 1;
141*4882a593Smuzhiyun 	}
142*4882a593Smuzhiyun 
143*4882a593Smuzhiyun 	return 0;
144*4882a593Smuzhiyun }
145*4882a593Smuzhiyun 
snd_soc_card_late_probe(struct snd_soc_card * card)146*4882a593Smuzhiyun int snd_soc_card_late_probe(struct snd_soc_card *card)
147*4882a593Smuzhiyun {
148*4882a593Smuzhiyun 	if (card->late_probe) {
149*4882a593Smuzhiyun 		int ret = card->late_probe(card);
150*4882a593Smuzhiyun 
151*4882a593Smuzhiyun 		if (ret < 0)
152*4882a593Smuzhiyun 			return soc_card_ret(card, ret);
153*4882a593Smuzhiyun 	}
154*4882a593Smuzhiyun 
155*4882a593Smuzhiyun 	/*
156*4882a593Smuzhiyun 	 * It has "card->probe" and "card->late_probe" callbacks,
157*4882a593Smuzhiyun 	 * and "late_probe" callback is called after "probe".
158*4882a593Smuzhiyun 	 * This means, we can set "card->probed" flag afer "late_probe"
159*4882a593Smuzhiyun 	 * for all cases.
160*4882a593Smuzhiyun 	 *
161*4882a593Smuzhiyun 	 * see
162*4882a593Smuzhiyun 	 *	snd_soc_bind_card()
163*4882a593Smuzhiyun 	 *	snd_soc_card_probe()
164*4882a593Smuzhiyun 	 */
165*4882a593Smuzhiyun 	card->probed = 1;
166*4882a593Smuzhiyun 
167*4882a593Smuzhiyun 	return 0;
168*4882a593Smuzhiyun }
169*4882a593Smuzhiyun 
snd_soc_card_remove(struct snd_soc_card * card)170*4882a593Smuzhiyun int snd_soc_card_remove(struct snd_soc_card *card)
171*4882a593Smuzhiyun {
172*4882a593Smuzhiyun 	int ret = 0;
173*4882a593Smuzhiyun 
174*4882a593Smuzhiyun 	if (card->probed &&
175*4882a593Smuzhiyun 	    card->remove)
176*4882a593Smuzhiyun 		ret = card->remove(card);
177*4882a593Smuzhiyun 
178*4882a593Smuzhiyun 	card->probed = 0;
179*4882a593Smuzhiyun 
180*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
181*4882a593Smuzhiyun }
182*4882a593Smuzhiyun 
snd_soc_card_set_bias_level(struct snd_soc_card * card,struct snd_soc_dapm_context * dapm,enum snd_soc_bias_level level)183*4882a593Smuzhiyun int snd_soc_card_set_bias_level(struct snd_soc_card *card,
184*4882a593Smuzhiyun 				struct snd_soc_dapm_context *dapm,
185*4882a593Smuzhiyun 				enum snd_soc_bias_level level)
186*4882a593Smuzhiyun {
187*4882a593Smuzhiyun 	int ret = 0;
188*4882a593Smuzhiyun 
189*4882a593Smuzhiyun 	if (card && card->set_bias_level)
190*4882a593Smuzhiyun 		ret = card->set_bias_level(card, dapm, level);
191*4882a593Smuzhiyun 
192*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
193*4882a593Smuzhiyun }
194*4882a593Smuzhiyun 
snd_soc_card_set_bias_level_post(struct snd_soc_card * card,struct snd_soc_dapm_context * dapm,enum snd_soc_bias_level level)195*4882a593Smuzhiyun int snd_soc_card_set_bias_level_post(struct snd_soc_card *card,
196*4882a593Smuzhiyun 				     struct snd_soc_dapm_context *dapm,
197*4882a593Smuzhiyun 				     enum snd_soc_bias_level level)
198*4882a593Smuzhiyun {
199*4882a593Smuzhiyun 	int ret = 0;
200*4882a593Smuzhiyun 
201*4882a593Smuzhiyun 	if (card && card->set_bias_level_post)
202*4882a593Smuzhiyun 		ret = card->set_bias_level_post(card, dapm, level);
203*4882a593Smuzhiyun 
204*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
205*4882a593Smuzhiyun }
206*4882a593Smuzhiyun 
snd_soc_card_add_dai_link(struct snd_soc_card * card,struct snd_soc_dai_link * dai_link)207*4882a593Smuzhiyun int snd_soc_card_add_dai_link(struct snd_soc_card *card,
208*4882a593Smuzhiyun 			      struct snd_soc_dai_link *dai_link)
209*4882a593Smuzhiyun {
210*4882a593Smuzhiyun 	int ret = 0;
211*4882a593Smuzhiyun 
212*4882a593Smuzhiyun 	if (card->add_dai_link)
213*4882a593Smuzhiyun 		ret = card->add_dai_link(card, dai_link);
214*4882a593Smuzhiyun 
215*4882a593Smuzhiyun 	return soc_card_ret(card, ret);
216*4882a593Smuzhiyun }
217*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(snd_soc_card_add_dai_link);
218*4882a593Smuzhiyun 
snd_soc_card_remove_dai_link(struct snd_soc_card * card,struct snd_soc_dai_link * dai_link)219*4882a593Smuzhiyun void snd_soc_card_remove_dai_link(struct snd_soc_card *card,
220*4882a593Smuzhiyun 				  struct snd_soc_dai_link *dai_link)
221*4882a593Smuzhiyun {
222*4882a593Smuzhiyun 	if (card->remove_dai_link)
223*4882a593Smuzhiyun 		card->remove_dai_link(card, dai_link);
224*4882a593Smuzhiyun }
225*4882a593Smuzhiyun EXPORT_SYMBOL_GPL(snd_soc_card_remove_dai_link);
226