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