xref: /linux/sound/soc/generic/simple-card-utils.c (revision e9f0878c4b2004ac19581274c1ae4c61ae3ca70e)
1 // SPDX-License-Identifier: GPL-2.0
2 //
3 // simple-card-utils.c
4 //
5 // Copyright (c) 2016 Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
6 
7 #include <linux/clk.h>
8 #include <linux/gpio.h>
9 #include <linux/gpio/consumer.h>
10 #include <linux/module.h>
11 #include <linux/of.h>
12 #include <linux/of_gpio.h>
13 #include <linux/of_graph.h>
14 #include <sound/jack.h>
15 #include <sound/simple_card_utils.h>
16 
17 void asoc_simple_card_convert_fixup(struct asoc_simple_card_data *data,
18 				    struct snd_pcm_hw_params *params)
19 {
20 	struct snd_interval *rate = hw_param_interval(params,
21 						SNDRV_PCM_HW_PARAM_RATE);
22 	struct snd_interval *channels = hw_param_interval(params,
23 						SNDRV_PCM_HW_PARAM_CHANNELS);
24 
25 	if (data->convert_rate)
26 		rate->min =
27 		rate->max = data->convert_rate;
28 
29 	if (data->convert_channels)
30 		channels->min =
31 		channels->max = data->convert_channels;
32 }
33 EXPORT_SYMBOL_GPL(asoc_simple_card_convert_fixup);
34 
35 void asoc_simple_card_parse_convert(struct device *dev, char *prefix,
36 				    struct asoc_simple_card_data *data)
37 {
38 	struct device_node *np = dev->of_node;
39 	char prop[128];
40 
41 	if (!prefix)
42 		prefix = "";
43 
44 	/* sampling rate convert */
45 	snprintf(prop, sizeof(prop), "%s%s", prefix, "convert-rate");
46 	of_property_read_u32(np, prop, &data->convert_rate);
47 
48 	/* channels transfer */
49 	snprintf(prop, sizeof(prop), "%s%s", prefix, "convert-channels");
50 	of_property_read_u32(np, prop, &data->convert_channels);
51 
52 	dev_dbg(dev, "convert_rate     %d\n", data->convert_rate);
53 	dev_dbg(dev, "convert_channels %d\n", data->convert_channels);
54 }
55 EXPORT_SYMBOL_GPL(asoc_simple_card_parse_convert);
56 
57 int asoc_simple_card_parse_daifmt(struct device *dev,
58 				  struct device_node *node,
59 				  struct device_node *codec,
60 				  char *prefix,
61 				  unsigned int *retfmt)
62 {
63 	struct device_node *bitclkmaster = NULL;
64 	struct device_node *framemaster = NULL;
65 	unsigned int daifmt;
66 
67 	daifmt = snd_soc_of_parse_daifmt(node, prefix,
68 					 &bitclkmaster, &framemaster);
69 	daifmt &= ~SND_SOC_DAIFMT_MASTER_MASK;
70 
71 	if (!bitclkmaster && !framemaster) {
72 		/*
73 		 * No dai-link level and master setting was not found from
74 		 * sound node level, revert back to legacy DT parsing and
75 		 * take the settings from codec node.
76 		 */
77 		dev_dbg(dev, "Revert to legacy daifmt parsing\n");
78 
79 		daifmt = snd_soc_of_parse_daifmt(codec, NULL, NULL, NULL) |
80 			(daifmt & ~SND_SOC_DAIFMT_CLOCK_MASK);
81 	} else {
82 		if (codec == bitclkmaster)
83 			daifmt |= (codec == framemaster) ?
84 				SND_SOC_DAIFMT_CBM_CFM : SND_SOC_DAIFMT_CBM_CFS;
85 		else
86 			daifmt |= (codec == framemaster) ?
87 				SND_SOC_DAIFMT_CBS_CFM : SND_SOC_DAIFMT_CBS_CFS;
88 	}
89 
90 	of_node_put(bitclkmaster);
91 	of_node_put(framemaster);
92 
93 	*retfmt = daifmt;
94 
95 	dev_dbg(dev, "format : %04x\n", daifmt);
96 
97 	return 0;
98 }
99 EXPORT_SYMBOL_GPL(asoc_simple_card_parse_daifmt);
100 
101 int asoc_simple_card_set_dailink_name(struct device *dev,
102 				      struct snd_soc_dai_link *dai_link,
103 				      const char *fmt, ...)
104 {
105 	va_list ap;
106 	char *name = NULL;
107 	int ret = -ENOMEM;
108 
109 	va_start(ap, fmt);
110 	name = devm_kvasprintf(dev, GFP_KERNEL, fmt, ap);
111 	va_end(ap);
112 
113 	if (name) {
114 		ret = 0;
115 
116 		dai_link->name		= name;
117 		dai_link->stream_name	= name;
118 
119 		dev_dbg(dev, "name : %s\n", name);
120 	}
121 
122 	return ret;
123 }
124 EXPORT_SYMBOL_GPL(asoc_simple_card_set_dailink_name);
125 
126 int asoc_simple_card_parse_card_name(struct snd_soc_card *card,
127 				     char *prefix)
128 {
129 	int ret;
130 
131 	if (!prefix)
132 		prefix = "";
133 
134 	/* Parse the card name from DT */
135 	ret = snd_soc_of_parse_card_name(card, "label");
136 	if (ret < 0 || !card->name) {
137 		char prop[128];
138 
139 		snprintf(prop, sizeof(prop), "%sname", prefix);
140 		ret = snd_soc_of_parse_card_name(card, prop);
141 		if (ret < 0)
142 			return ret;
143 	}
144 
145 	if (!card->name && card->dai_link)
146 		card->name = card->dai_link->name;
147 
148 	dev_dbg(card->dev, "Card Name: %s\n", card->name ? card->name : "");
149 
150 	return 0;
151 }
152 EXPORT_SYMBOL_GPL(asoc_simple_card_parse_card_name);
153 
154 static void asoc_simple_card_clk_register(struct asoc_simple_dai *dai,
155 					  struct clk *clk)
156 {
157 	dai->clk = clk;
158 }
159 
160 int asoc_simple_card_clk_enable(struct asoc_simple_dai *dai)
161 {
162 	return clk_prepare_enable(dai->clk);
163 }
164 EXPORT_SYMBOL_GPL(asoc_simple_card_clk_enable);
165 
166 void asoc_simple_card_clk_disable(struct asoc_simple_dai *dai)
167 {
168 	clk_disable_unprepare(dai->clk);
169 }
170 EXPORT_SYMBOL_GPL(asoc_simple_card_clk_disable);
171 
172 int asoc_simple_card_parse_clk(struct device *dev,
173 			       struct device_node *node,
174 			       struct device_node *dai_of_node,
175 			       struct asoc_simple_dai *simple_dai,
176 			       const char *name)
177 {
178 	struct clk *clk;
179 	u32 val;
180 
181 	/*
182 	 * Parse dai->sysclk come from "clocks = <&xxx>"
183 	 * (if system has common clock)
184 	 *  or "system-clock-frequency = <xxx>"
185 	 *  or device's module clock.
186 	 */
187 	clk = devm_get_clk_from_child(dev, node, NULL);
188 	if (!IS_ERR(clk)) {
189 		simple_dai->sysclk = clk_get_rate(clk);
190 
191 		asoc_simple_card_clk_register(simple_dai, clk);
192 	} else if (!of_property_read_u32(node, "system-clock-frequency", &val)) {
193 		simple_dai->sysclk = val;
194 	} else {
195 		clk = devm_get_clk_from_child(dev, dai_of_node, NULL);
196 		if (!IS_ERR(clk))
197 			simple_dai->sysclk = clk_get_rate(clk);
198 	}
199 
200 	if (of_property_read_bool(node, "system-clock-direction-out"))
201 		simple_dai->clk_direction = SND_SOC_CLOCK_OUT;
202 
203 	dev_dbg(dev, "%s : sysclk = %d, direction %d\n", name,
204 		simple_dai->sysclk, simple_dai->clk_direction);
205 
206 	return 0;
207 }
208 EXPORT_SYMBOL_GPL(asoc_simple_card_parse_clk);
209 
210 int asoc_simple_card_parse_dai(struct device_node *node,
211 				    struct device_node **dai_of_node,
212 				    const char **dai_name,
213 				    const char *list_name,
214 				    const char *cells_name,
215 				    int *is_single_link)
216 {
217 	struct of_phandle_args args;
218 	int ret;
219 
220 	if (!node)
221 		return 0;
222 
223 	/*
224 	 * Get node via "sound-dai = <&phandle port>"
225 	 * it will be used as xxx_of_node on soc_bind_dai_link()
226 	 */
227 	ret = of_parse_phandle_with_args(node, list_name, cells_name, 0, &args);
228 	if (ret)
229 		return ret;
230 
231 	/* Get dai->name */
232 	if (dai_name) {
233 		ret = snd_soc_of_get_dai_name(node, dai_name);
234 		if (ret < 0)
235 			return ret;
236 	}
237 
238 	*dai_of_node = args.np;
239 
240 	if (is_single_link)
241 		*is_single_link = !args.args_count;
242 
243 	return 0;
244 }
245 EXPORT_SYMBOL_GPL(asoc_simple_card_parse_dai);
246 
247 static int asoc_simple_card_get_dai_id(struct device_node *ep)
248 {
249 	struct device_node *node;
250 	struct device_node *endpoint;
251 	int i, id;
252 	int ret;
253 
254 	ret = snd_soc_get_dai_id(ep);
255 	if (ret != -ENOTSUPP)
256 		return ret;
257 
258 	node = of_graph_get_port_parent(ep);
259 
260 	/*
261 	 * Non HDMI sound case, counting port/endpoint on its DT
262 	 * is enough. Let's count it.
263 	 */
264 	i = 0;
265 	id = -1;
266 	for_each_endpoint_of_node(node, endpoint) {
267 		if (endpoint == ep)
268 			id = i;
269 		i++;
270 	}
271 
272 	of_node_put(node);
273 
274 	if (id < 0)
275 		return -ENODEV;
276 
277 	return id;
278 }
279 
280 int asoc_simple_card_parse_graph_dai(struct device_node *ep,
281 				     struct device_node **dai_of_node,
282 				     const char **dai_name)
283 {
284 	struct device_node *node;
285 	struct of_phandle_args args;
286 	int ret;
287 
288 	if (!ep)
289 		return 0;
290 	if (!dai_name)
291 		return 0;
292 
293 	node = of_graph_get_port_parent(ep);
294 
295 	/* Get dai->name */
296 	args.np		= node;
297 	args.args[0]	= asoc_simple_card_get_dai_id(ep);
298 	args.args_count	= (of_graph_get_endpoint_count(node) > 1);
299 
300 	ret = snd_soc_get_dai_name(&args, dai_name);
301 	if (ret < 0)
302 		return ret;
303 
304 	*dai_of_node = node;
305 
306 	return 0;
307 }
308 EXPORT_SYMBOL_GPL(asoc_simple_card_parse_graph_dai);
309 
310 int asoc_simple_card_init_dai(struct snd_soc_dai *dai,
311 			      struct asoc_simple_dai *simple_dai)
312 {
313 	int ret;
314 
315 	if (simple_dai->sysclk) {
316 		ret = snd_soc_dai_set_sysclk(dai, 0, simple_dai->sysclk,
317 					     simple_dai->clk_direction);
318 		if (ret && ret != -ENOTSUPP) {
319 			dev_err(dai->dev, "simple-card: set_sysclk error\n");
320 			return ret;
321 		}
322 	}
323 
324 	if (simple_dai->slots) {
325 		ret = snd_soc_dai_set_tdm_slot(dai,
326 					       simple_dai->tx_slot_mask,
327 					       simple_dai->rx_slot_mask,
328 					       simple_dai->slots,
329 					       simple_dai->slot_width);
330 		if (ret && ret != -ENOTSUPP) {
331 			dev_err(dai->dev, "simple-card: set_tdm_slot error\n");
332 			return ret;
333 		}
334 	}
335 
336 	return 0;
337 }
338 EXPORT_SYMBOL_GPL(asoc_simple_card_init_dai);
339 
340 int asoc_simple_card_canonicalize_dailink(struct snd_soc_dai_link *dai_link)
341 {
342 	/* Assumes platform == cpu */
343 	if (!dai_link->platform_of_node)
344 		dai_link->platform_of_node = dai_link->cpu_of_node;
345 
346 	return 0;
347 }
348 EXPORT_SYMBOL_GPL(asoc_simple_card_canonicalize_dailink);
349 
350 void asoc_simple_card_canonicalize_cpu(struct snd_soc_dai_link *dai_link,
351 				       int is_single_links)
352 {
353 	/*
354 	 * In soc_bind_dai_link() will check cpu name after
355 	 * of_node matching if dai_link has cpu_dai_name.
356 	 * but, it will never match if name was created by
357 	 * fmt_single_name() remove cpu_dai_name if cpu_args
358 	 * was 0. See:
359 	 *	fmt_single_name()
360 	 *	fmt_multiple_name()
361 	 */
362 	if (is_single_links)
363 		dai_link->cpu_dai_name = NULL;
364 }
365 EXPORT_SYMBOL_GPL(asoc_simple_card_canonicalize_cpu);
366 
367 int asoc_simple_card_clean_reference(struct snd_soc_card *card)
368 {
369 	struct snd_soc_dai_link *dai_link;
370 	int num_links;
371 
372 	for (num_links = 0, dai_link = card->dai_link;
373 	     num_links < card->num_links;
374 	     num_links++, dai_link++) {
375 		of_node_put(dai_link->cpu_of_node);
376 		of_node_put(dai_link->codec_of_node);
377 	}
378 	return 0;
379 }
380 EXPORT_SYMBOL_GPL(asoc_simple_card_clean_reference);
381 
382 int asoc_simple_card_of_parse_routing(struct snd_soc_card *card,
383 				      char *prefix,
384 				      int optional)
385 {
386 	struct device_node *node = card->dev->of_node;
387 	char prop[128];
388 
389 	if (!prefix)
390 		prefix = "";
391 
392 	snprintf(prop, sizeof(prop), "%s%s", prefix, "routing");
393 
394 	if (!of_property_read_bool(node, prop)) {
395 		if (optional)
396 			return 0;
397 		return -EINVAL;
398 	}
399 
400 	return snd_soc_of_parse_audio_routing(card, prop);
401 }
402 EXPORT_SYMBOL_GPL(asoc_simple_card_of_parse_routing);
403 
404 int asoc_simple_card_of_parse_widgets(struct snd_soc_card *card,
405 				      char *prefix)
406 {
407 	struct device_node *node = card->dev->of_node;
408 	char prop[128];
409 
410 	if (!prefix)
411 		prefix = "";
412 
413 	snprintf(prop, sizeof(prop), "%s%s", prefix, "widgets");
414 
415 	if (of_property_read_bool(node, prop))
416 		return snd_soc_of_parse_audio_simple_widgets(card, prop);
417 
418 	/* no widgets is not error */
419 	return 0;
420 }
421 EXPORT_SYMBOL_GPL(asoc_simple_card_of_parse_widgets);
422 
423 int asoc_simple_card_init_jack(struct snd_soc_card *card,
424 			       struct asoc_simple_jack *sjack,
425 			       int is_hp, char *prefix)
426 {
427 	struct device *dev = card->dev;
428 	enum of_gpio_flags flags;
429 	char prop[128];
430 	char *pin_name;
431 	char *gpio_name;
432 	int mask;
433 	int det;
434 
435 	if (!prefix)
436 		prefix = "";
437 
438 	sjack->gpio.gpio = -ENOENT;
439 
440 	if (is_hp) {
441 		snprintf(prop, sizeof(prop), "%shp-det-gpio", prefix);
442 		pin_name	= "Headphones";
443 		gpio_name	= "Headphone detection";
444 		mask		= SND_JACK_HEADPHONE;
445 	} else {
446 		snprintf(prop, sizeof(prop), "%smic-det-gpio", prefix);
447 		pin_name	= "Mic Jack";
448 		gpio_name	= "Mic detection";
449 		mask		= SND_JACK_MICROPHONE;
450 	}
451 
452 	det = of_get_named_gpio_flags(dev->of_node, prop, 0, &flags);
453 	if (det == -EPROBE_DEFER)
454 		return -EPROBE_DEFER;
455 
456 	if (gpio_is_valid(det)) {
457 		sjack->pin.pin		= pin_name;
458 		sjack->pin.mask		= mask;
459 
460 		sjack->gpio.name	= gpio_name;
461 		sjack->gpio.report	= mask;
462 		sjack->gpio.gpio	= det;
463 		sjack->gpio.invert	= !!(flags & OF_GPIO_ACTIVE_LOW);
464 		sjack->gpio.debounce_time = 150;
465 
466 		snd_soc_card_jack_new(card, pin_name, mask,
467 				      &sjack->jack,
468 				      &sjack->pin, 1);
469 
470 		snd_soc_jack_add_gpios(&sjack->jack, 1,
471 				       &sjack->gpio);
472 	}
473 
474 	return 0;
475 }
476 EXPORT_SYMBOL_GPL(asoc_simple_card_init_jack);
477 
478 /* Module information */
479 MODULE_AUTHOR("Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>");
480 MODULE_DESCRIPTION("ALSA SoC Simple Card Utils");
481 MODULE_LICENSE("GPL v2");
482