xref: /linux/sound/soc/meson/axg-tdm-interface.c (revision 7f71507851fc7764b36a3221839607d3a45c2025)
1 // SPDX-License-Identifier: (GPL-2.0 OR MIT)
2 //
3 // Copyright (c) 2018 BayLibre, SAS.
4 // Author: Jerome Brunet <jbrunet@baylibre.com>
5 
6 #include <linux/clk.h>
7 #include <linux/module.h>
8 #include <linux/of_platform.h>
9 #include <sound/pcm_params.h>
10 #include <sound/soc.h>
11 #include <sound/soc-dai.h>
12 
13 #include "axg-tdm.h"
14 
15 /* Maximum bit clock frequency according the datasheets */
16 #define MAX_SCLK 100000000 /* Hz */
17 
18 enum {
19 	TDM_IFACE_PAD,
20 	TDM_IFACE_LOOPBACK,
21 };
22 
23 static unsigned int axg_tdm_slots_total(u32 *mask)
24 {
25 	unsigned int slots = 0;
26 	int i;
27 
28 	if (!mask)
29 		return 0;
30 
31 	/* Count the total number of slots provided by all 4 lanes */
32 	for (i = 0; i < AXG_TDM_NUM_LANES; i++)
33 		slots += hweight32(mask[i]);
34 
35 	return slots;
36 }
37 
38 int axg_tdm_set_tdm_slots(struct snd_soc_dai *dai, u32 *tx_mask,
39 			  u32 *rx_mask, unsigned int slots,
40 			  unsigned int slot_width)
41 {
42 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
43 	struct axg_tdm_stream *tx = snd_soc_dai_dma_data_get_playback(dai);
44 	struct axg_tdm_stream *rx = snd_soc_dai_dma_data_get_capture(dai);
45 	unsigned int tx_slots, rx_slots;
46 	unsigned int fmt = 0;
47 
48 	tx_slots = axg_tdm_slots_total(tx_mask);
49 	rx_slots = axg_tdm_slots_total(rx_mask);
50 
51 	/* We should at least have a slot for a valid interface */
52 	if (!tx_slots && !rx_slots) {
53 		dev_err(dai->dev, "interface has no slot\n");
54 		return -EINVAL;
55 	}
56 
57 	iface->slots = slots;
58 
59 	switch (slot_width) {
60 	case 0:
61 		slot_width = 32;
62 		fallthrough;
63 	case 32:
64 		fmt |= SNDRV_PCM_FMTBIT_S32_LE;
65 		fallthrough;
66 	case 24:
67 		fmt |= SNDRV_PCM_FMTBIT_S24_LE;
68 		fmt |= SNDRV_PCM_FMTBIT_S20_LE;
69 		fallthrough;
70 	case 16:
71 		fmt |= SNDRV_PCM_FMTBIT_S16_LE;
72 		fallthrough;
73 	case 8:
74 		fmt |= SNDRV_PCM_FMTBIT_S8;
75 		break;
76 	default:
77 		dev_err(dai->dev, "unsupported slot width: %d\n", slot_width);
78 		return -EINVAL;
79 	}
80 
81 	iface->slot_width = slot_width;
82 
83 	/* Amend the dai driver and let dpcm merge do its job */
84 	if (tx) {
85 		tx->mask = tx_mask;
86 		dai->driver->playback.channels_max = tx_slots;
87 		dai->driver->playback.formats = fmt;
88 	}
89 
90 	if (rx) {
91 		rx->mask = rx_mask;
92 		dai->driver->capture.channels_max = rx_slots;
93 		dai->driver->capture.formats = fmt;
94 	}
95 
96 	return 0;
97 }
98 EXPORT_SYMBOL_GPL(axg_tdm_set_tdm_slots);
99 
100 static int axg_tdm_iface_set_sysclk(struct snd_soc_dai *dai, int clk_id,
101 				    unsigned int freq, int dir)
102 {
103 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
104 	int ret = -ENOTSUPP;
105 
106 	if (dir == SND_SOC_CLOCK_OUT && clk_id == 0) {
107 		if (!iface->mclk) {
108 			dev_warn(dai->dev, "master clock not provided\n");
109 		} else {
110 			ret = clk_set_rate(iface->mclk, freq);
111 			if (!ret)
112 				iface->mclk_rate = freq;
113 		}
114 	}
115 
116 	return ret;
117 }
118 
119 static int axg_tdm_iface_set_fmt(struct snd_soc_dai *dai, unsigned int fmt)
120 {
121 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
122 
123 	switch (fmt & SND_SOC_DAIFMT_CLOCK_PROVIDER_MASK) {
124 	case SND_SOC_DAIFMT_BP_FP:
125 		if (!iface->mclk) {
126 			dev_err(dai->dev, "cpu clock master: mclk missing\n");
127 			return -ENODEV;
128 		}
129 		break;
130 
131 	case SND_SOC_DAIFMT_BC_FC:
132 		break;
133 
134 	case SND_SOC_DAIFMT_BP_FC:
135 	case SND_SOC_DAIFMT_BC_FP:
136 		dev_err(dai->dev, "only BP_FP and BC_FC are supported\n");
137 		fallthrough;
138 	default:
139 		return -EINVAL;
140 	}
141 
142 	iface->fmt = fmt;
143 	return 0;
144 }
145 
146 static int axg_tdm_iface_startup(struct snd_pcm_substream *substream,
147 				 struct snd_soc_dai *dai)
148 {
149 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
150 	struct axg_tdm_stream *ts =
151 		snd_soc_dai_get_dma_data(dai, substream);
152 	int ret;
153 
154 	if (!axg_tdm_slots_total(ts->mask)) {
155 		dev_err(dai->dev, "interface has not slots\n");
156 		return -EINVAL;
157 	}
158 
159 	if (snd_soc_component_active(dai->component)) {
160 		/* Apply component wide rate symmetry */
161 		ret = snd_pcm_hw_constraint_single(substream->runtime,
162 						   SNDRV_PCM_HW_PARAM_RATE,
163 						   iface->rate);
164 
165 	} else {
166 		/* Limit rate according to the slot number and width */
167 		unsigned int max_rate =
168 			MAX_SCLK / (iface->slots * iface->slot_width);
169 		ret = snd_pcm_hw_constraint_minmax(substream->runtime,
170 						   SNDRV_PCM_HW_PARAM_RATE,
171 						   0, max_rate);
172 	}
173 
174 	if (ret < 0)
175 		dev_err(dai->dev, "can't set iface rate constraint\n");
176 	else
177 		ret = 0;
178 
179 	return ret;
180 }
181 
182 static int axg_tdm_iface_set_stream(struct snd_pcm_substream *substream,
183 				    struct snd_pcm_hw_params *params,
184 				    struct snd_soc_dai *dai)
185 {
186 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
187 	struct axg_tdm_stream *ts = snd_soc_dai_get_dma_data(dai, substream);
188 	unsigned int channels = params_channels(params);
189 	unsigned int width = params_width(params);
190 
191 	/* Save rate and sample_bits for component symmetry */
192 	iface->rate = params_rate(params);
193 
194 	/* Make sure this interface can cope with the stream */
195 	if (axg_tdm_slots_total(ts->mask) < channels) {
196 		dev_err(dai->dev, "not enough slots for channels\n");
197 		return -EINVAL;
198 	}
199 
200 	if (iface->slot_width < width) {
201 		dev_err(dai->dev, "incompatible slots width for stream\n");
202 		return -EINVAL;
203 	}
204 
205 	/* Save the parameter for tdmout/tdmin widgets */
206 	ts->physical_width = params_physical_width(params);
207 	ts->width = params_width(params);
208 	ts->channels = params_channels(params);
209 
210 	return 0;
211 }
212 
213 static int axg_tdm_iface_set_lrclk(struct snd_soc_dai *dai,
214 				   struct snd_pcm_hw_params *params)
215 {
216 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
217 	unsigned int ratio_num;
218 	int ret;
219 
220 	ret = clk_set_rate(iface->lrclk, params_rate(params));
221 	if (ret) {
222 		dev_err(dai->dev, "setting sample clock failed: %d\n", ret);
223 		return ret;
224 	}
225 
226 	switch (iface->fmt & SND_SOC_DAIFMT_FORMAT_MASK) {
227 	case SND_SOC_DAIFMT_I2S:
228 	case SND_SOC_DAIFMT_LEFT_J:
229 	case SND_SOC_DAIFMT_RIGHT_J:
230 		/* 50% duty cycle ratio */
231 		ratio_num = 1;
232 		break;
233 
234 	case SND_SOC_DAIFMT_DSP_A:
235 	case SND_SOC_DAIFMT_DSP_B:
236 		/*
237 		 * A zero duty cycle ratio will result in setting the mininum
238 		 * ratio possible which, for this clock, is 1 cycle of the
239 		 * parent bclk clock high and the rest low, This is exactly
240 		 * what we want here.
241 		 */
242 		ratio_num = 0;
243 		break;
244 
245 	default:
246 		return -EINVAL;
247 	}
248 
249 	ret = clk_set_duty_cycle(iface->lrclk, ratio_num, 2);
250 	if (ret) {
251 		dev_err(dai->dev,
252 			"setting sample clock duty cycle failed: %d\n", ret);
253 		return ret;
254 	}
255 
256 	/* Set sample clock inversion */
257 	ret = clk_set_phase(iface->lrclk,
258 			    axg_tdm_lrclk_invert(iface->fmt) ? 180 : 0);
259 	if (ret) {
260 		dev_err(dai->dev,
261 			"setting sample clock phase failed: %d\n", ret);
262 		return ret;
263 	}
264 
265 	return 0;
266 }
267 
268 static int axg_tdm_iface_set_sclk(struct snd_soc_dai *dai,
269 				  struct snd_pcm_hw_params *params)
270 {
271 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
272 	unsigned long srate;
273 	int ret;
274 
275 	srate = iface->slots * iface->slot_width * params_rate(params);
276 
277 	if (!iface->mclk_rate) {
278 		/* If no specific mclk is requested, default to bit clock * 2 */
279 		clk_set_rate(iface->mclk, 2 * srate);
280 	} else {
281 		/* Check if we can actually get the bit clock from mclk */
282 		if (iface->mclk_rate % srate) {
283 			dev_err(dai->dev,
284 				"can't derive sclk %lu from mclk %lu\n",
285 				srate, iface->mclk_rate);
286 			return -EINVAL;
287 		}
288 	}
289 
290 	ret = clk_set_rate(iface->sclk, srate);
291 	if (ret) {
292 		dev_err(dai->dev, "setting bit clock failed: %d\n", ret);
293 		return ret;
294 	}
295 
296 	/* Set the bit clock inversion */
297 	ret = clk_set_phase(iface->sclk,
298 			    axg_tdm_sclk_invert(iface->fmt) ? 0 : 180);
299 	if (ret) {
300 		dev_err(dai->dev, "setting bit clock phase failed: %d\n", ret);
301 		return ret;
302 	}
303 
304 	return ret;
305 }
306 
307 static int axg_tdm_iface_hw_params(struct snd_pcm_substream *substream,
308 				   struct snd_pcm_hw_params *params,
309 				   struct snd_soc_dai *dai)
310 {
311 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
312 	struct axg_tdm_stream *ts = snd_soc_dai_get_dma_data(dai, substream);
313 	int ret;
314 
315 	switch (iface->fmt & SND_SOC_DAIFMT_FORMAT_MASK) {
316 	case SND_SOC_DAIFMT_I2S:
317 	case SND_SOC_DAIFMT_LEFT_J:
318 	case SND_SOC_DAIFMT_RIGHT_J:
319 		if (iface->slots > 2) {
320 			dev_err(dai->dev, "bad slot number for format: %d\n",
321 				iface->slots);
322 			return -EINVAL;
323 		}
324 		break;
325 
326 	case SND_SOC_DAIFMT_DSP_A:
327 	case SND_SOC_DAIFMT_DSP_B:
328 		break;
329 
330 	default:
331 		dev_err(dai->dev, "unsupported dai format\n");
332 		return -EINVAL;
333 	}
334 
335 	ret = axg_tdm_iface_set_stream(substream, params, dai);
336 	if (ret)
337 		return ret;
338 
339 	if ((iface->fmt & SND_SOC_DAIFMT_CLOCK_PROVIDER_MASK) ==
340 	    SND_SOC_DAIFMT_BP_FP) {
341 		ret = axg_tdm_iface_set_sclk(dai, params);
342 		if (ret)
343 			return ret;
344 
345 		ret = axg_tdm_iface_set_lrclk(dai, params);
346 		if (ret)
347 			return ret;
348 	}
349 
350 	ret = axg_tdm_stream_set_cont_clocks(ts, iface->fmt);
351 	if (ret)
352 		dev_err(dai->dev, "failed to apply continuous clock setting\n");
353 
354 	return ret;
355 }
356 
357 static int axg_tdm_iface_hw_free(struct snd_pcm_substream *substream,
358 				 struct snd_soc_dai *dai)
359 {
360 	struct axg_tdm_stream *ts = snd_soc_dai_get_dma_data(dai, substream);
361 
362 	return axg_tdm_stream_set_cont_clocks(ts, 0);
363 }
364 
365 static int axg_tdm_iface_trigger(struct snd_pcm_substream *substream,
366 				 int cmd,
367 				 struct snd_soc_dai *dai)
368 {
369 	struct axg_tdm_stream *ts =
370 		snd_soc_dai_get_dma_data(dai, substream);
371 
372 	switch (cmd) {
373 	case SNDRV_PCM_TRIGGER_START:
374 	case SNDRV_PCM_TRIGGER_RESUME:
375 	case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:
376 		axg_tdm_stream_start(ts);
377 		break;
378 	case SNDRV_PCM_TRIGGER_SUSPEND:
379 	case SNDRV_PCM_TRIGGER_PAUSE_PUSH:
380 	case SNDRV_PCM_TRIGGER_STOP:
381 		axg_tdm_stream_stop(ts);
382 		break;
383 	default:
384 		return -EINVAL;
385 	}
386 
387 	return 0;
388 }
389 
390 static int axg_tdm_iface_remove_dai(struct snd_soc_dai *dai)
391 {
392 	int stream;
393 
394 	for_each_pcm_streams(stream) {
395 		struct axg_tdm_stream *ts = snd_soc_dai_dma_data_get(dai, stream);
396 
397 		if (ts)
398 			axg_tdm_stream_free(ts);
399 	}
400 
401 	return 0;
402 }
403 
404 static int axg_tdm_iface_probe_dai(struct snd_soc_dai *dai)
405 {
406 	struct axg_tdm_iface *iface = snd_soc_dai_get_drvdata(dai);
407 	int stream;
408 
409 	for_each_pcm_streams(stream) {
410 		struct axg_tdm_stream *ts;
411 
412 		if (!snd_soc_dai_get_widget(dai, stream))
413 			continue;
414 
415 		ts = axg_tdm_stream_alloc(iface);
416 		if (!ts) {
417 			axg_tdm_iface_remove_dai(dai);
418 			return -ENOMEM;
419 		}
420 		snd_soc_dai_dma_data_set(dai, stream, ts);
421 	}
422 
423 	return 0;
424 }
425 
426 static const struct snd_soc_dai_ops axg_tdm_iface_ops = {
427 	.probe		= axg_tdm_iface_probe_dai,
428 	.remove		= axg_tdm_iface_remove_dai,
429 	.set_sysclk	= axg_tdm_iface_set_sysclk,
430 	.set_fmt	= axg_tdm_iface_set_fmt,
431 	.startup	= axg_tdm_iface_startup,
432 	.hw_params	= axg_tdm_iface_hw_params,
433 	.hw_free	= axg_tdm_iface_hw_free,
434 	.trigger	= axg_tdm_iface_trigger,
435 };
436 
437 /* TDM Backend DAIs */
438 static const struct snd_soc_dai_driver axg_tdm_iface_dai_drv[] = {
439 	[TDM_IFACE_PAD] = {
440 		.name = "TDM Pad",
441 		.playback = {
442 			.stream_name	= "Playback",
443 			.channels_min	= 1,
444 			.channels_max	= AXG_TDM_CHANNEL_MAX,
445 			.rates		= SNDRV_PCM_RATE_CONTINUOUS,
446 			.rate_min	= 5512,
447 			.rate_max	= 768000,
448 			.formats	= AXG_TDM_FORMATS,
449 		},
450 		.capture = {
451 			.stream_name	= "Capture",
452 			.channels_min	= 1,
453 			.channels_max	= AXG_TDM_CHANNEL_MAX,
454 			.rates		= SNDRV_PCM_RATE_CONTINUOUS,
455 			.rate_min	= 5512,
456 			.rate_max	= 768000,
457 			.formats	= AXG_TDM_FORMATS,
458 		},
459 		.id = TDM_IFACE_PAD,
460 		.ops = &axg_tdm_iface_ops,
461 	},
462 	[TDM_IFACE_LOOPBACK] = {
463 		.name = "TDM Loopback",
464 		.capture = {
465 			.stream_name	= "Loopback",
466 			.channels_min	= 1,
467 			.channels_max	= AXG_TDM_CHANNEL_MAX,
468 			.rates		= SNDRV_PCM_RATE_CONTINUOUS,
469 			.rate_min	= 5512,
470 			.rate_max	= 768000,
471 			.formats	= AXG_TDM_FORMATS,
472 		},
473 		.id = TDM_IFACE_LOOPBACK,
474 		.ops = &axg_tdm_iface_ops,
475 	},
476 };
477 
478 static int axg_tdm_iface_set_bias_level(struct snd_soc_component *component,
479 					enum snd_soc_bias_level level)
480 {
481 	struct axg_tdm_iface *iface = snd_soc_component_get_drvdata(component);
482 	enum snd_soc_bias_level now =
483 		snd_soc_component_get_bias_level(component);
484 	int ret = 0;
485 
486 	switch (level) {
487 	case SND_SOC_BIAS_PREPARE:
488 		if (now == SND_SOC_BIAS_STANDBY)
489 			ret = clk_prepare_enable(iface->mclk);
490 		break;
491 
492 	case SND_SOC_BIAS_STANDBY:
493 		if (now == SND_SOC_BIAS_PREPARE)
494 			clk_disable_unprepare(iface->mclk);
495 		break;
496 
497 	case SND_SOC_BIAS_OFF:
498 	case SND_SOC_BIAS_ON:
499 		break;
500 	}
501 
502 	return ret;
503 }
504 
505 static const struct snd_soc_dapm_widget axg_tdm_iface_dapm_widgets[] = {
506 	SND_SOC_DAPM_SIGGEN("Playback Signal"),
507 };
508 
509 static const struct snd_soc_dapm_route axg_tdm_iface_dapm_routes[] = {
510 	{ "Loopback", NULL, "Playback Signal" },
511 };
512 
513 static const struct snd_soc_component_driver axg_tdm_iface_component_drv = {
514 	.dapm_widgets		= axg_tdm_iface_dapm_widgets,
515 	.num_dapm_widgets	= ARRAY_SIZE(axg_tdm_iface_dapm_widgets),
516 	.dapm_routes		= axg_tdm_iface_dapm_routes,
517 	.num_dapm_routes	= ARRAY_SIZE(axg_tdm_iface_dapm_routes),
518 	.set_bias_level		= axg_tdm_iface_set_bias_level,
519 };
520 
521 static const struct of_device_id axg_tdm_iface_of_match[] = {
522 	{ .compatible = "amlogic,axg-tdm-iface", },
523 	{}
524 };
525 MODULE_DEVICE_TABLE(of, axg_tdm_iface_of_match);
526 
527 static int axg_tdm_iface_probe(struct platform_device *pdev)
528 {
529 	struct device *dev = &pdev->dev;
530 	struct snd_soc_dai_driver *dai_drv;
531 	struct axg_tdm_iface *iface;
532 	int i;
533 
534 	iface = devm_kzalloc(dev, sizeof(*iface), GFP_KERNEL);
535 	if (!iface)
536 		return -ENOMEM;
537 	platform_set_drvdata(pdev, iface);
538 
539 	/*
540 	 * Duplicate dai driver: depending on the slot masks configuration
541 	 * We'll change the number of channel provided by DAI stream, so dpcm
542 	 * channel merge can be done properly
543 	 */
544 	dai_drv = devm_kcalloc(dev, ARRAY_SIZE(axg_tdm_iface_dai_drv),
545 			       sizeof(*dai_drv), GFP_KERNEL);
546 	if (!dai_drv)
547 		return -ENOMEM;
548 
549 	for (i = 0; i < ARRAY_SIZE(axg_tdm_iface_dai_drv); i++)
550 		memcpy(&dai_drv[i], &axg_tdm_iface_dai_drv[i],
551 		       sizeof(*dai_drv));
552 
553 	/* Bit clock provided on the pad */
554 	iface->sclk = devm_clk_get(dev, "sclk");
555 	if (IS_ERR(iface->sclk))
556 		return dev_err_probe(dev, PTR_ERR(iface->sclk), "failed to get sclk\n");
557 
558 	/* Sample clock provided on the pad */
559 	iface->lrclk = devm_clk_get(dev, "lrclk");
560 	if (IS_ERR(iface->lrclk))
561 		return dev_err_probe(dev, PTR_ERR(iface->lrclk), "failed to get lrclk\n");
562 
563 	/*
564 	 * mclk maybe be missing when the cpu dai is in slave mode and
565 	 * the codec does not require it to provide a master clock.
566 	 * At this point, ignore the error if mclk is missing. We'll
567 	 * throw an error if the cpu dai is master and mclk is missing
568 	 */
569 	iface->mclk = devm_clk_get_optional(dev, "mclk");
570 	if (IS_ERR(iface->mclk))
571 		return dev_err_probe(dev, PTR_ERR(iface->mclk), "failed to get mclk\n");
572 
573 	return devm_snd_soc_register_component(dev,
574 					&axg_tdm_iface_component_drv, dai_drv,
575 					ARRAY_SIZE(axg_tdm_iface_dai_drv));
576 }
577 
578 static struct platform_driver axg_tdm_iface_pdrv = {
579 	.probe = axg_tdm_iface_probe,
580 	.driver = {
581 		.name = "axg-tdm-iface",
582 		.of_match_table = axg_tdm_iface_of_match,
583 	},
584 };
585 module_platform_driver(axg_tdm_iface_pdrv);
586 
587 MODULE_DESCRIPTION("Amlogic AXG TDM interface driver");
588 MODULE_AUTHOR("Jerome Brunet <jbrunet@baylibre.com>");
589 MODULE_LICENSE("GPL v2");
590