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_locked(struct snd_soc_card * soc_card,const char * name)32 struct snd_kcontrol *snd_soc_card_get_kcontrol_locked(struct snd_soc_card *soc_card,
33 const char *name)
34 {
35 struct snd_card *card = soc_card->snd_card;
36 struct snd_kcontrol *kctl;
37
38 /* must be held read or write */
39 lockdep_assert_held(&card->controls_rwsem);
40
41 if (unlikely(!name))
42 return NULL;
43
44 list_for_each_entry(kctl, &card->controls, list)
45 if (!strncmp(kctl->id.name, name, sizeof(kctl->id.name)))
46 return kctl;
47 return NULL;
48 }
49 EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol_locked);
50
snd_soc_card_get_kcontrol(struct snd_soc_card * soc_card,const char * name)51 struct snd_kcontrol *snd_soc_card_get_kcontrol(struct snd_soc_card *soc_card,
52 const char *name)
53 {
54 struct snd_card *card = soc_card->snd_card;
55 struct snd_kcontrol *kctl;
56
57 down_read(&card->controls_rwsem);
58 kctl = snd_soc_card_get_kcontrol_locked(soc_card, name);
59 up_read(&card->controls_rwsem);
60
61 return kctl;
62 }
63 EXPORT_SYMBOL_GPL(snd_soc_card_get_kcontrol);
64
jack_new(struct snd_soc_card * card,const char * id,int type,struct snd_soc_jack * jack,bool initial_kctl)65 static int jack_new(struct snd_soc_card *card, const char *id, int type,
66 struct snd_soc_jack *jack, bool initial_kctl)
67 {
68 mutex_init(&jack->mutex);
69 jack->card = card;
70 INIT_LIST_HEAD(&jack->pins);
71 INIT_LIST_HEAD(&jack->jack_zones);
72 BLOCKING_INIT_NOTIFIER_HEAD(&jack->notifier);
73
74 return snd_jack_new(card->snd_card, id, type, &jack->jack, initial_kctl, false);
75 }
76
77 /**
78 * snd_soc_card_jack_new - Create a new jack without pins
79 * @card: ASoC card
80 * @id: an identifying string for this jack
81 * @type: a bitmask of enum snd_jack_type values that can be detected by
82 * this jack
83 * @jack: structure to use for the jack
84 *
85 * Creates a new jack object without pins. If adding pins later,
86 * snd_soc_card_jack_new_pins() should be used instead with 0 as num_pins
87 * argument.
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(struct snd_soc_card * card,const char * id,int type,struct snd_soc_jack * jack)92 int snd_soc_card_jack_new(struct snd_soc_card *card, const char *id, int type,
93 struct snd_soc_jack *jack)
94 {
95 return soc_card_ret(card, jack_new(card, id, type, jack, true));
96 }
97 EXPORT_SYMBOL_GPL(snd_soc_card_jack_new);
98
99 /**
100 * snd_soc_card_jack_new_pins - Create a new jack with pins
101 * @card: ASoC card
102 * @id: an identifying string for this jack
103 * @type: a bitmask of enum snd_jack_type values that can be detected by
104 * this jack
105 * @jack: structure to use for the jack
106 * @pins: Array of jack pins to be added to the jack or NULL
107 * @num_pins: Number of elements in the @pins array
108 *
109 * Creates a new jack object with pins. If not adding pins,
110 * snd_soc_card_jack_new() should be used instead.
111 *
112 * Returns zero if successful, or a negative error code on failure.
113 * On success jack will be initialised.
114 */
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)115 int snd_soc_card_jack_new_pins(struct snd_soc_card *card, const char *id,
116 int type, struct snd_soc_jack *jack,
117 struct snd_soc_jack_pin *pins,
118 unsigned int num_pins)
119 {
120 int ret;
121
122 ret = jack_new(card, id, type, jack, false);
123 if (ret)
124 goto end;
125
126 if (num_pins)
127 ret = snd_soc_jack_add_pins(jack, num_pins, pins);
128 end:
129 return soc_card_ret(card, ret);
130 }
131 EXPORT_SYMBOL_GPL(snd_soc_card_jack_new_pins);
132
snd_soc_card_suspend_pre(struct snd_soc_card * card)133 int snd_soc_card_suspend_pre(struct snd_soc_card *card)
134 {
135 int ret = 0;
136
137 if (card->suspend_pre)
138 ret = card->suspend_pre(card);
139
140 return soc_card_ret(card, ret);
141 }
142
snd_soc_card_suspend_post(struct snd_soc_card * card)143 int snd_soc_card_suspend_post(struct snd_soc_card *card)
144 {
145 int ret = 0;
146
147 if (card->suspend_post)
148 ret = card->suspend_post(card);
149
150 return soc_card_ret(card, ret);
151 }
152
snd_soc_card_resume_pre(struct snd_soc_card * card)153 int snd_soc_card_resume_pre(struct snd_soc_card *card)
154 {
155 int ret = 0;
156
157 if (card->resume_pre)
158 ret = card->resume_pre(card);
159
160 return soc_card_ret(card, ret);
161 }
162
snd_soc_card_resume_post(struct snd_soc_card * card)163 int snd_soc_card_resume_post(struct snd_soc_card *card)
164 {
165 int ret = 0;
166
167 if (card->resume_post)
168 ret = card->resume_post(card);
169
170 return soc_card_ret(card, ret);
171 }
172
snd_soc_card_probe(struct snd_soc_card * card)173 int snd_soc_card_probe(struct snd_soc_card *card)
174 {
175 if (card->probe) {
176 int ret = card->probe(card);
177
178 if (ret < 0)
179 return soc_card_ret(card, ret);
180
181 /*
182 * It has "card->probe" and "card->late_probe" callbacks.
183 * So, set "probed" flag here, because it needs to care
184 * about "late_probe".
185 *
186 * see
187 * snd_soc_bind_card()
188 * snd_soc_card_late_probe()
189 */
190 card->probed = 1;
191 }
192
193 return 0;
194 }
195
snd_soc_card_late_probe(struct snd_soc_card * card)196 int snd_soc_card_late_probe(struct snd_soc_card *card)
197 {
198 if (card->late_probe) {
199 int ret = card->late_probe(card);
200
201 if (ret < 0)
202 return soc_card_ret(card, ret);
203 }
204
205 /*
206 * It has "card->probe" and "card->late_probe" callbacks,
207 * and "late_probe" callback is called after "probe".
208 * This means, we can set "card->probed" flag afer "late_probe"
209 * for all cases.
210 *
211 * see
212 * snd_soc_bind_card()
213 * snd_soc_card_probe()
214 */
215 card->probed = 1;
216
217 return 0;
218 }
219
snd_soc_card_fixup_controls(struct snd_soc_card * card)220 void snd_soc_card_fixup_controls(struct snd_soc_card *card)
221 {
222 if (card->fixup_controls)
223 card->fixup_controls(card);
224 }
225
snd_soc_card_remove(struct snd_soc_card * card)226 int snd_soc_card_remove(struct snd_soc_card *card)
227 {
228 int ret = 0;
229
230 if (card->probed &&
231 card->remove)
232 ret = card->remove(card);
233
234 card->probed = 0;
235
236 return soc_card_ret(card, ret);
237 }
238
snd_soc_card_set_bias_level(struct snd_soc_card * card,struct snd_soc_dapm_context * dapm,enum snd_soc_bias_level level)239 int snd_soc_card_set_bias_level(struct snd_soc_card *card,
240 struct snd_soc_dapm_context *dapm,
241 enum snd_soc_bias_level level)
242 {
243 int ret = 0;
244
245 if (card && card->set_bias_level)
246 ret = card->set_bias_level(card, dapm, level);
247
248 return soc_card_ret(card, ret);
249 }
250
snd_soc_card_set_bias_level_post(struct snd_soc_card * card,struct snd_soc_dapm_context * dapm,enum snd_soc_bias_level level)251 int snd_soc_card_set_bias_level_post(struct snd_soc_card *card,
252 struct snd_soc_dapm_context *dapm,
253 enum snd_soc_bias_level level)
254 {
255 int ret = 0;
256
257 if (card && card->set_bias_level_post)
258 ret = card->set_bias_level_post(card, dapm, level);
259
260 return soc_card_ret(card, ret);
261 }
262
snd_soc_card_add_dai_link(struct snd_soc_card * card,struct snd_soc_dai_link * dai_link)263 int snd_soc_card_add_dai_link(struct snd_soc_card *card,
264 struct snd_soc_dai_link *dai_link)
265 {
266 int ret = 0;
267
268 if (card->add_dai_link)
269 ret = card->add_dai_link(card, dai_link);
270
271 return soc_card_ret(card, ret);
272 }
273 EXPORT_SYMBOL_GPL(snd_soc_card_add_dai_link);
274
snd_soc_card_remove_dai_link(struct snd_soc_card * card,struct snd_soc_dai_link * dai_link)275 void snd_soc_card_remove_dai_link(struct snd_soc_card *card,
276 struct snd_soc_dai_link *dai_link)
277 {
278 if (card->remove_dai_link)
279 card->remove_dai_link(card, dai_link);
280 }
281 EXPORT_SYMBOL_GPL(snd_soc_card_remove_dai_link);
282