1 // SPDX-License-Identifier: GPL-2.0
5 // Copyright 2009-2011 Wolfson Microelectronics PLC.
6 // Copyright (C) 2019 Renesas Electronics Corp.
8 // Mark Brown <broonie@opensource.wolfsonmicro.com>
9 // Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
11 #include <linux/module.h>
12 #include <linux/pm_runtime.h>
13 #include <sound/soc.h>
14 #include <linux/bitops.h>
16 #define soc_component_ret(dai, ret) _soc_component_ret(dai, __func__, ret, -1)
17 #define soc_component_ret_reg_rw(dai, ret, reg) _soc_component_ret(dai, __func__, ret, reg)
18 static inline int _soc_component_ret(struct snd_soc_component *component,
19 const char *func, int ret, int reg)
21 /* Positive/Zero values are not errors */
25 /* Negative values might be errors */
32 dev_err(component->dev,
33 "ASoC: error at %s on %s: %d\n",
34 func, component->name, ret);
36 dev_err(component->dev,
37 "ASoC: error at %s on %s for register: [0x%08x] %d\n",
38 func, component->name, reg, ret);
44 static inline int soc_component_field_shift(struct snd_soc_component *component,
48 dev_err(component->dev, "ASoC: error field mask is zero for %s\n",
53 return (ffs(mask) - 1);
57 * We might want to check substream by using list.
58 * In such case, we can update these macros.
60 #define soc_component_mark_push(component, substream, tgt) ((component)->mark_##tgt = substream)
61 #define soc_component_mark_pop(component, substream, tgt) ((component)->mark_##tgt = NULL)
62 #define soc_component_mark_match(component, substream, tgt) ((component)->mark_##tgt == substream)
64 void snd_soc_component_set_aux(struct snd_soc_component *component,
65 struct snd_soc_aux_dev *aux)
67 component->init = (aux) ? aux->init : NULL;
70 int snd_soc_component_init(struct snd_soc_component *component)
75 ret = component->init(component);
77 return soc_component_ret(component, ret);
81 * snd_soc_component_set_sysclk - configure COMPONENT system or master clock.
82 * @component: COMPONENT
83 * @clk_id: DAI specific clock ID
84 * @source: Source for the clock
85 * @freq: new clock frequency in Hz
86 * @dir: new clock direction - input/output.
88 * Configures the CODEC master (MCLK) or system (SYSCLK) clocking.
90 int snd_soc_component_set_sysclk(struct snd_soc_component *component,
91 int clk_id, int source, unsigned int freq,
96 if (component->driver->set_sysclk)
97 ret = component->driver->set_sysclk(component, clk_id, source,
100 return soc_component_ret(component, ret);
102 EXPORT_SYMBOL_GPL(snd_soc_component_set_sysclk);
105 * snd_soc_component_set_pll - configure component PLL.
106 * @component: COMPONENT
107 * @pll_id: DAI specific PLL ID
108 * @source: DAI specific source for the PLL
109 * @freq_in: PLL input clock frequency in Hz
110 * @freq_out: requested PLL output clock frequency in Hz
112 * Configures and enables PLL to generate output clock based on input clock.
114 int snd_soc_component_set_pll(struct snd_soc_component *component, int pll_id,
115 int source, unsigned int freq_in,
116 unsigned int freq_out)
120 if (component->driver->set_pll)
121 ret = component->driver->set_pll(component, pll_id, source,
124 return soc_component_ret(component, ret);
126 EXPORT_SYMBOL_GPL(snd_soc_component_set_pll);
128 void snd_soc_component_seq_notifier(struct snd_soc_component *component,
129 enum snd_soc_dapm_type type, int subseq)
131 if (component->driver->seq_notifier)
132 component->driver->seq_notifier(component, type, subseq);
135 int snd_soc_component_stream_event(struct snd_soc_component *component,
140 if (component->driver->stream_event)
141 ret = component->driver->stream_event(component, event);
143 return soc_component_ret(component, ret);
146 int snd_soc_component_set_bias_level(struct snd_soc_component *component,
147 enum snd_soc_bias_level level)
151 if (component->driver->set_bias_level)
152 ret = component->driver->set_bias_level(component, level);
154 return soc_component_ret(component, ret);
157 int snd_soc_component_enable_pin(struct snd_soc_component *component,
160 struct snd_soc_dapm_context *dapm =
161 snd_soc_component_get_dapm(component);
162 return snd_soc_dapm_enable_pin(dapm, pin);
164 EXPORT_SYMBOL_GPL(snd_soc_component_enable_pin);
166 int snd_soc_component_enable_pin_unlocked(struct snd_soc_component *component,
169 struct snd_soc_dapm_context *dapm =
170 snd_soc_component_get_dapm(component);
171 return snd_soc_dapm_enable_pin_unlocked(dapm, pin);
173 EXPORT_SYMBOL_GPL(snd_soc_component_enable_pin_unlocked);
175 int snd_soc_component_disable_pin(struct snd_soc_component *component,
178 struct snd_soc_dapm_context *dapm =
179 snd_soc_component_get_dapm(component);
180 return snd_soc_dapm_disable_pin(dapm, pin);
182 EXPORT_SYMBOL_GPL(snd_soc_component_disable_pin);
184 int snd_soc_component_disable_pin_unlocked(struct snd_soc_component *component,
187 struct snd_soc_dapm_context *dapm =
188 snd_soc_component_get_dapm(component);
189 return snd_soc_dapm_disable_pin_unlocked(dapm, pin);
191 EXPORT_SYMBOL_GPL(snd_soc_component_disable_pin_unlocked);
193 int snd_soc_component_nc_pin(struct snd_soc_component *component,
196 struct snd_soc_dapm_context *dapm =
197 snd_soc_component_get_dapm(component);
198 return snd_soc_dapm_nc_pin(dapm, pin);
200 EXPORT_SYMBOL_GPL(snd_soc_component_nc_pin);
202 int snd_soc_component_nc_pin_unlocked(struct snd_soc_component *component,
205 struct snd_soc_dapm_context *dapm =
206 snd_soc_component_get_dapm(component);
207 return snd_soc_dapm_nc_pin_unlocked(dapm, pin);
209 EXPORT_SYMBOL_GPL(snd_soc_component_nc_pin_unlocked);
211 int snd_soc_component_get_pin_status(struct snd_soc_component *component,
214 struct snd_soc_dapm_context *dapm =
215 snd_soc_component_get_dapm(component);
216 return snd_soc_dapm_get_pin_status(dapm, pin);
218 EXPORT_SYMBOL_GPL(snd_soc_component_get_pin_status);
220 int snd_soc_component_force_enable_pin(struct snd_soc_component *component,
223 struct snd_soc_dapm_context *dapm =
224 snd_soc_component_get_dapm(component);
225 return snd_soc_dapm_force_enable_pin(dapm, pin);
227 EXPORT_SYMBOL_GPL(snd_soc_component_force_enable_pin);
229 int snd_soc_component_force_enable_pin_unlocked(
230 struct snd_soc_component *component,
233 struct snd_soc_dapm_context *dapm =
234 snd_soc_component_get_dapm(component);
235 return snd_soc_dapm_force_enable_pin_unlocked(dapm, pin);
237 EXPORT_SYMBOL_GPL(snd_soc_component_force_enable_pin_unlocked);
239 int snd_soc_component_notify_control(struct snd_soc_component *component,
240 const char * const ctl)
242 char name[SNDRV_CTL_ELEM_ID_NAME_MAXLEN];
243 struct snd_kcontrol *kctl;
245 /* When updating, change also snd_soc_dapm_widget_name_cmp() */
246 if (component->name_prefix)
247 snprintf(name, ARRAY_SIZE(name), "%s %s", component->name_prefix, ctl);
249 snprintf(name, ARRAY_SIZE(name), "%s", ctl);
251 kctl = snd_soc_card_get_kcontrol(component->card, name);
253 return soc_component_ret(component, -EINVAL);
255 snd_ctl_notify(component->card->snd_card,
256 SNDRV_CTL_EVENT_MASK_VALUE, &kctl->id);
260 EXPORT_SYMBOL_GPL(snd_soc_component_notify_control);
263 * snd_soc_component_set_jack - configure component jack.
264 * @component: COMPONENTs
265 * @jack: structure to use for the jack
266 * @data: can be used if codec driver need extra data for configuring jack
268 * Configures and enables jack detection function.
270 int snd_soc_component_set_jack(struct snd_soc_component *component,
271 struct snd_soc_jack *jack, void *data)
275 if (component->driver->set_jack)
276 ret = component->driver->set_jack(component, jack, data);
278 return soc_component_ret(component, ret);
280 EXPORT_SYMBOL_GPL(snd_soc_component_set_jack);
283 * snd_soc_component_get_jack_type
284 * @component: COMPONENTs
286 * Returns the jack type of the component
287 * This can either be the supported type or one read from
288 * devicetree with the property: jack-type.
290 int snd_soc_component_get_jack_type(
291 struct snd_soc_component *component)
295 if (component->driver->get_jack_type)
296 ret = component->driver->get_jack_type(component);
298 return soc_component_ret(component, ret);
300 EXPORT_SYMBOL_GPL(snd_soc_component_get_jack_type);
302 int snd_soc_component_module_get(struct snd_soc_component *component,
303 void *mark, int upon_open)
307 if (component->driver->module_get_upon_open == !!upon_open &&
308 !try_module_get(component->dev->driver->owner))
311 /* mark module if succeeded */
313 soc_component_mark_push(component, mark, module);
315 return soc_component_ret(component, ret);
318 void snd_soc_component_module_put(struct snd_soc_component *component,
319 void *mark, int upon_open, int rollback)
321 if (rollback && !soc_component_mark_match(component, mark, module))
324 if (component->driver->module_get_upon_open == !!upon_open)
325 module_put(component->dev->driver->owner);
327 /* remove the mark from module */
328 soc_component_mark_pop(component, mark, module);
331 int snd_soc_component_open(struct snd_soc_component *component,
332 struct snd_pcm_substream *substream)
336 if (component->driver->open)
337 ret = component->driver->open(component, substream);
339 /* mark substream if succeeded */
341 soc_component_mark_push(component, substream, open);
343 return soc_component_ret(component, ret);
346 int snd_soc_component_close(struct snd_soc_component *component,
347 struct snd_pcm_substream *substream,
352 if (rollback && !soc_component_mark_match(component, substream, open))
355 if (component->driver->close)
356 ret = component->driver->close(component, substream);
358 /* remove marked substream */
359 soc_component_mark_pop(component, substream, open);
361 return soc_component_ret(component, ret);
364 void snd_soc_component_suspend(struct snd_soc_component *component)
366 if (component->driver->suspend)
367 component->driver->suspend(component);
368 component->suspended = 1;
371 void snd_soc_component_resume(struct snd_soc_component *component)
373 if (component->driver->resume)
374 component->driver->resume(component);
375 component->suspended = 0;
378 int snd_soc_component_is_suspended(struct snd_soc_component *component)
380 return component->suspended;
383 int snd_soc_component_probe(struct snd_soc_component *component)
387 if (component->driver->probe)
388 ret = component->driver->probe(component);
390 return soc_component_ret(component, ret);
393 void snd_soc_component_remove(struct snd_soc_component *component)
395 if (component->driver->remove)
396 component->driver->remove(component);
399 int snd_soc_component_of_xlate_dai_id(struct snd_soc_component *component,
400 struct device_node *ep)
404 if (component->driver->of_xlate_dai_id)
405 ret = component->driver->of_xlate_dai_id(component, ep);
407 return soc_component_ret(component, ret);
410 int snd_soc_component_of_xlate_dai_name(struct snd_soc_component *component,
411 const struct of_phandle_args *args,
412 const char **dai_name)
414 if (component->driver->of_xlate_dai_name)
415 return component->driver->of_xlate_dai_name(component,
418 * Don't use soc_component_ret here because we may not want to report
419 * the error just yet. If a device has more than one component, the
420 * first may not match and we don't want spam the log with this.
425 void snd_soc_component_setup_regmap(struct snd_soc_component *component)
427 int val_bytes = regmap_get_val_bytes(component->regmap);
429 /* Errors are legitimate for non-integer byte multiples */
431 component->val_bytes = val_bytes;
437 * snd_soc_component_init_regmap() - Initialize regmap instance for the
439 * @component: The component for which to initialize the regmap instance
440 * @regmap: The regmap instance that should be used by the component
442 * This function allows deferred assignment of the regmap instance that is
443 * associated with the component. Only use this if the regmap instance is not
444 * yet ready when the component is registered. The function must also be called
445 * before the first IO attempt of the component.
447 void snd_soc_component_init_regmap(struct snd_soc_component *component,
448 struct regmap *regmap)
450 component->regmap = regmap;
451 snd_soc_component_setup_regmap(component);
453 EXPORT_SYMBOL_GPL(snd_soc_component_init_regmap);
456 * snd_soc_component_exit_regmap() - De-initialize regmap instance for the
458 * @component: The component for which to de-initialize the regmap instance
460 * Calls regmap_exit() on the regmap instance associated to the component and
461 * removes the regmap instance from the component.
463 * This function should only be used if snd_soc_component_init_regmap() was used
464 * to initialize the regmap instance.
466 void snd_soc_component_exit_regmap(struct snd_soc_component *component)
468 regmap_exit(component->regmap);
469 component->regmap = NULL;
471 EXPORT_SYMBOL_GPL(snd_soc_component_exit_regmap);
475 int snd_soc_component_compr_open(struct snd_soc_component *component,
476 struct snd_compr_stream *cstream)
480 if (component->driver->compress_ops &&
481 component->driver->compress_ops->open)
482 ret = component->driver->compress_ops->open(component, cstream);
484 /* mark substream if succeeded */
486 soc_component_mark_push(component, cstream, compr_open);
488 return soc_component_ret(component, ret);
490 EXPORT_SYMBOL_GPL(snd_soc_component_compr_open);
492 void snd_soc_component_compr_free(struct snd_soc_component *component,
493 struct snd_compr_stream *cstream,
496 if (rollback && !soc_component_mark_match(component, cstream, compr_open))
499 if (component->driver->compress_ops &&
500 component->driver->compress_ops->free)
501 component->driver->compress_ops->free(component, cstream);
503 /* remove marked substream */
504 soc_component_mark_pop(component, cstream, compr_open);
506 EXPORT_SYMBOL_GPL(snd_soc_component_compr_free);
508 int snd_soc_component_compr_trigger(struct snd_compr_stream *cstream, int cmd)
510 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
511 struct snd_soc_component *component;
514 for_each_rtd_components(rtd, i, component) {
515 if (component->driver->compress_ops &&
516 component->driver->compress_ops->trigger) {
517 ret = component->driver->compress_ops->trigger(
518 component, cstream, cmd);
520 return soc_component_ret(component, ret);
526 EXPORT_SYMBOL_GPL(snd_soc_component_compr_trigger);
528 int snd_soc_component_compr_set_params(struct snd_compr_stream *cstream,
529 struct snd_compr_params *params)
531 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
532 struct snd_soc_component *component;
535 for_each_rtd_components(rtd, i, component) {
536 if (component->driver->compress_ops &&
537 component->driver->compress_ops->set_params) {
538 ret = component->driver->compress_ops->set_params(
539 component, cstream, params);
541 return soc_component_ret(component, ret);
547 EXPORT_SYMBOL_GPL(snd_soc_component_compr_set_params);
549 int snd_soc_component_compr_get_params(struct snd_compr_stream *cstream,
550 struct snd_codec *params)
552 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
553 struct snd_soc_component *component;
556 for_each_rtd_components(rtd, i, component) {
557 if (component->driver->compress_ops &&
558 component->driver->compress_ops->get_params) {
559 ret = component->driver->compress_ops->get_params(
560 component, cstream, params);
561 return soc_component_ret(component, ret);
567 EXPORT_SYMBOL_GPL(snd_soc_component_compr_get_params);
569 int snd_soc_component_compr_get_caps(struct snd_compr_stream *cstream,
570 struct snd_compr_caps *caps)
572 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
573 struct snd_soc_component *component;
576 snd_soc_dpcm_mutex_lock(rtd);
578 for_each_rtd_components(rtd, i, component) {
579 if (component->driver->compress_ops &&
580 component->driver->compress_ops->get_caps) {
581 ret = component->driver->compress_ops->get_caps(
582 component, cstream, caps);
587 snd_soc_dpcm_mutex_unlock(rtd);
589 return soc_component_ret(component, ret);
591 EXPORT_SYMBOL_GPL(snd_soc_component_compr_get_caps);
593 int snd_soc_component_compr_get_codec_caps(struct snd_compr_stream *cstream,
594 struct snd_compr_codec_caps *codec)
596 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
597 struct snd_soc_component *component;
600 snd_soc_dpcm_mutex_lock(rtd);
602 for_each_rtd_components(rtd, i, component) {
603 if (component->driver->compress_ops &&
604 component->driver->compress_ops->get_codec_caps) {
605 ret = component->driver->compress_ops->get_codec_caps(
606 component, cstream, codec);
611 snd_soc_dpcm_mutex_unlock(rtd);
613 return soc_component_ret(component, ret);
615 EXPORT_SYMBOL_GPL(snd_soc_component_compr_get_codec_caps);
617 int snd_soc_component_compr_ack(struct snd_compr_stream *cstream, size_t bytes)
619 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
620 struct snd_soc_component *component;
623 for_each_rtd_components(rtd, i, component) {
624 if (component->driver->compress_ops &&
625 component->driver->compress_ops->ack) {
626 ret = component->driver->compress_ops->ack(
627 component, cstream, bytes);
629 return soc_component_ret(component, ret);
635 EXPORT_SYMBOL_GPL(snd_soc_component_compr_ack);
637 int snd_soc_component_compr_pointer(struct snd_compr_stream *cstream,
638 struct snd_compr_tstamp *tstamp)
640 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
641 struct snd_soc_component *component;
644 for_each_rtd_components(rtd, i, component) {
645 if (component->driver->compress_ops &&
646 component->driver->compress_ops->pointer) {
647 ret = component->driver->compress_ops->pointer(
648 component, cstream, tstamp);
649 return soc_component_ret(component, ret);
655 EXPORT_SYMBOL_GPL(snd_soc_component_compr_pointer);
657 int snd_soc_component_compr_copy(struct snd_compr_stream *cstream,
658 char __user *buf, size_t count)
660 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
661 struct snd_soc_component *component;
664 snd_soc_dpcm_mutex_lock(rtd);
666 for_each_rtd_components(rtd, i, component) {
667 if (component->driver->compress_ops &&
668 component->driver->compress_ops->copy) {
669 ret = component->driver->compress_ops->copy(
670 component, cstream, buf, count);
675 snd_soc_dpcm_mutex_unlock(rtd);
677 return soc_component_ret(component, ret);
679 EXPORT_SYMBOL_GPL(snd_soc_component_compr_copy);
681 int snd_soc_component_compr_set_metadata(struct snd_compr_stream *cstream,
682 struct snd_compr_metadata *metadata)
684 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
685 struct snd_soc_component *component;
688 for_each_rtd_components(rtd, i, component) {
689 if (component->driver->compress_ops &&
690 component->driver->compress_ops->set_metadata) {
691 ret = component->driver->compress_ops->set_metadata(
692 component, cstream, metadata);
694 return soc_component_ret(component, ret);
700 EXPORT_SYMBOL_GPL(snd_soc_component_compr_set_metadata);
702 int snd_soc_component_compr_get_metadata(struct snd_compr_stream *cstream,
703 struct snd_compr_metadata *metadata)
705 struct snd_soc_pcm_runtime *rtd = cstream->private_data;
706 struct snd_soc_component *component;
709 for_each_rtd_components(rtd, i, component) {
710 if (component->driver->compress_ops &&
711 component->driver->compress_ops->get_metadata) {
712 ret = component->driver->compress_ops->get_metadata(
713 component, cstream, metadata);
714 return soc_component_ret(component, ret);
720 EXPORT_SYMBOL_GPL(snd_soc_component_compr_get_metadata);
722 static unsigned int soc_component_read_no_lock(
723 struct snd_soc_component *component,
727 unsigned int val = 0;
729 if (component->regmap)
730 ret = regmap_read(component->regmap, reg, &val);
731 else if (component->driver->read) {
733 val = component->driver->read(component, reg);
739 return soc_component_ret_reg_rw(component, ret, reg);
745 * snd_soc_component_read() - Read register value
746 * @component: Component to read from
747 * @reg: Register to read
751 unsigned int snd_soc_component_read(struct snd_soc_component *component,
756 mutex_lock(&component->io_mutex);
757 val = soc_component_read_no_lock(component, reg);
758 mutex_unlock(&component->io_mutex);
762 EXPORT_SYMBOL_GPL(snd_soc_component_read);
764 static int soc_component_write_no_lock(
765 struct snd_soc_component *component,
766 unsigned int reg, unsigned int val)
770 if (component->regmap)
771 ret = regmap_write(component->regmap, reg, val);
772 else if (component->driver->write)
773 ret = component->driver->write(component, reg, val);
775 return soc_component_ret_reg_rw(component, ret, reg);
779 * snd_soc_component_write() - Write register value
780 * @component: Component to write to
781 * @reg: Register to write
782 * @val: Value to write to the register
784 * Return: 0 on success, a negative error code otherwise.
786 int snd_soc_component_write(struct snd_soc_component *component,
787 unsigned int reg, unsigned int val)
791 mutex_lock(&component->io_mutex);
792 ret = soc_component_write_no_lock(component, reg, val);
793 mutex_unlock(&component->io_mutex);
797 EXPORT_SYMBOL_GPL(snd_soc_component_write);
799 static int snd_soc_component_update_bits_legacy(
800 struct snd_soc_component *component, unsigned int reg,
801 unsigned int mask, unsigned int val, bool *change)
803 unsigned int old, new;
806 mutex_lock(&component->io_mutex);
808 old = soc_component_read_no_lock(component, reg);
810 new = (old & ~mask) | (val & mask);
811 *change = old != new;
813 ret = soc_component_write_no_lock(component, reg, new);
815 mutex_unlock(&component->io_mutex);
817 return soc_component_ret_reg_rw(component, ret, reg);
821 * snd_soc_component_update_bits() - Perform read/modify/write cycle
822 * @component: Component to update
823 * @reg: Register to update
824 * @mask: Mask that specifies which bits to update
825 * @val: New value for the bits specified by mask
827 * Return: 1 if the operation was successful and the value of the register
828 * changed, 0 if the operation was successful, but the value did not change.
829 * Returns a negative error code otherwise.
831 int snd_soc_component_update_bits(struct snd_soc_component *component,
832 unsigned int reg, unsigned int mask, unsigned int val)
837 if (component->regmap)
838 ret = regmap_update_bits_check(component->regmap, reg, mask,
841 ret = snd_soc_component_update_bits_legacy(component, reg,
845 return soc_component_ret_reg_rw(component, ret, reg);
848 EXPORT_SYMBOL_GPL(snd_soc_component_update_bits);
851 * snd_soc_component_update_bits_async() - Perform asynchronous
852 * read/modify/write cycle
853 * @component: Component to update
854 * @reg: Register to update
855 * @mask: Mask that specifies which bits to update
856 * @val: New value for the bits specified by mask
858 * This function is similar to snd_soc_component_update_bits(), but the update
859 * operation is scheduled asynchronously. This means it may not be completed
860 * when the function returns. To make sure that all scheduled updates have been
861 * completed snd_soc_component_async_complete() must be called.
863 * Return: 1 if the operation was successful and the value of the register
864 * changed, 0 if the operation was successful, but the value did not change.
865 * Returns a negative error code otherwise.
867 int snd_soc_component_update_bits_async(struct snd_soc_component *component,
868 unsigned int reg, unsigned int mask, unsigned int val)
873 if (component->regmap)
874 ret = regmap_update_bits_check_async(component->regmap, reg,
877 ret = snd_soc_component_update_bits_legacy(component, reg,
881 return soc_component_ret_reg_rw(component, ret, reg);
884 EXPORT_SYMBOL_GPL(snd_soc_component_update_bits_async);
887 * snd_soc_component_read_field() - Read register field value
888 * @component: Component to read from
889 * @reg: Register to read
890 * @mask: mask of the register field
892 * Return: read value of register field.
894 unsigned int snd_soc_component_read_field(struct snd_soc_component *component,
895 unsigned int reg, unsigned int mask)
899 val = snd_soc_component_read(component, reg);
901 val = (val & mask) >> soc_component_field_shift(component, mask);
905 EXPORT_SYMBOL_GPL(snd_soc_component_read_field);
908 * snd_soc_component_write_field() - write to register field
909 * @component: Component to write to
910 * @reg: Register to write
911 * @mask: mask of the register field to update
912 * @val: value of the field to write
914 * Return: 1 for change, otherwise 0.
916 int snd_soc_component_write_field(struct snd_soc_component *component,
917 unsigned int reg, unsigned int mask,
921 val = (val << soc_component_field_shift(component, mask)) & mask;
923 return snd_soc_component_update_bits(component, reg, mask, val);
925 EXPORT_SYMBOL_GPL(snd_soc_component_write_field);
928 * snd_soc_component_async_complete() - Ensure asynchronous I/O has completed
929 * @component: Component for which to wait
931 * This function blocks until all asynchronous I/O which has previously been
932 * scheduled using snd_soc_component_update_bits_async() has completed.
934 void snd_soc_component_async_complete(struct snd_soc_component *component)
936 if (component->regmap)
937 regmap_async_complete(component->regmap);
939 EXPORT_SYMBOL_GPL(snd_soc_component_async_complete);
942 * snd_soc_component_test_bits - Test register for change
943 * @component: component
944 * @reg: Register to test
945 * @mask: Mask that specifies which bits to test
946 * @value: Value to test against
948 * Tests a register with a new value and checks if the new value is
949 * different from the old value.
951 * Return: 1 for change, otherwise 0.
953 int snd_soc_component_test_bits(struct snd_soc_component *component,
954 unsigned int reg, unsigned int mask, unsigned int value)
956 unsigned int old, new;
958 old = snd_soc_component_read(component, reg);
959 new = (old & ~mask) | value;
962 EXPORT_SYMBOL_GPL(snd_soc_component_test_bits);
964 int snd_soc_pcm_component_pointer(struct snd_pcm_substream *substream)
966 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
967 struct snd_soc_component *component;
970 /* FIXME: use 1st pointer */
971 for_each_rtd_components(rtd, i, component)
972 if (component->driver->pointer)
973 return component->driver->pointer(component, substream);
978 static bool snd_soc_component_is_codec_on_rtd(struct snd_soc_pcm_runtime *rtd,
979 struct snd_soc_component *component)
981 struct snd_soc_dai *dai;
984 for_each_rtd_codec_dais(rtd, i, dai) {
985 if (dai->component == component)
992 void snd_soc_pcm_component_delay(struct snd_pcm_substream *substream,
993 snd_pcm_sframes_t *cpu_delay,
994 snd_pcm_sframes_t *codec_delay)
996 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
997 struct snd_soc_component *component;
998 snd_pcm_sframes_t delay;
1002 * We're looking for the delay through the full audio path so it needs to
1003 * be the maximum of the Components doing transmit and the maximum of the
1004 * Components doing receive (ie, all CPUs and all CODECs) rather than
1005 * just the maximum of all Components.
1007 for_each_rtd_components(rtd, i, component) {
1008 if (!component->driver->delay)
1011 delay = component->driver->delay(component, substream);
1013 if (snd_soc_component_is_codec_on_rtd(rtd, component))
1014 *codec_delay = max(*codec_delay, delay);
1016 *cpu_delay = max(*cpu_delay, delay);
1020 int snd_soc_pcm_component_ioctl(struct snd_pcm_substream *substream,
1021 unsigned int cmd, void *arg)
1023 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1024 struct snd_soc_component *component;
1027 /* FIXME: use 1st ioctl */
1028 for_each_rtd_components(rtd, i, component)
1029 if (component->driver->ioctl)
1030 return soc_component_ret(
1032 component->driver->ioctl(component,
1033 substream, cmd, arg));
1035 return snd_pcm_lib_ioctl(substream, cmd, arg);
1038 int snd_soc_pcm_component_sync_stop(struct snd_pcm_substream *substream)
1040 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1041 struct snd_soc_component *component;
1044 for_each_rtd_components(rtd, i, component) {
1045 if (component->driver->sync_stop) {
1046 ret = component->driver->sync_stop(component,
1049 return soc_component_ret(component, ret);
1056 int snd_soc_pcm_component_copy(struct snd_pcm_substream *substream,
1057 int channel, unsigned long pos,
1058 struct iov_iter *iter, unsigned long bytes)
1060 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1061 struct snd_soc_component *component;
1064 /* FIXME. it returns 1st copy now */
1065 for_each_rtd_components(rtd, i, component)
1066 if (component->driver->copy)
1067 return soc_component_ret(component,
1068 component->driver->copy(component, substream,
1069 channel, pos, iter, bytes));
1074 struct page *snd_soc_pcm_component_page(struct snd_pcm_substream *substream,
1075 unsigned long offset)
1077 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1078 struct snd_soc_component *component;
1082 /* FIXME. it returns 1st page now */
1083 for_each_rtd_components(rtd, i, component) {
1084 if (component->driver->page) {
1085 page = component->driver->page(component,
1095 int snd_soc_pcm_component_mmap(struct snd_pcm_substream *substream,
1096 struct vm_area_struct *vma)
1098 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1099 struct snd_soc_component *component;
1102 /* FIXME. it returns 1st mmap now */
1103 for_each_rtd_components(rtd, i, component)
1104 if (component->driver->mmap)
1105 return soc_component_ret(
1107 component->driver->mmap(component,
1113 int snd_soc_pcm_component_new(struct snd_soc_pcm_runtime *rtd)
1115 struct snd_soc_component *component;
1119 for_each_rtd_components(rtd, i, component) {
1120 if (component->driver->pcm_construct) {
1121 ret = component->driver->pcm_construct(component, rtd);
1123 return soc_component_ret(component, ret);
1130 void snd_soc_pcm_component_free(struct snd_soc_pcm_runtime *rtd)
1132 struct snd_soc_component *component;
1138 for_each_rtd_components(rtd, i, component)
1139 if (component->driver->pcm_destruct)
1140 component->driver->pcm_destruct(component, rtd->pcm);
1143 int snd_soc_pcm_component_prepare(struct snd_pcm_substream *substream)
1145 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1146 struct snd_soc_component *component;
1149 for_each_rtd_components(rtd, i, component) {
1150 if (component->driver->prepare) {
1151 ret = component->driver->prepare(component, substream);
1153 return soc_component_ret(component, ret);
1160 int snd_soc_pcm_component_hw_params(struct snd_pcm_substream *substream,
1161 struct snd_pcm_hw_params *params)
1163 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1164 struct snd_soc_component *component;
1167 for_each_rtd_components(rtd, i, component) {
1168 if (component->driver->hw_params) {
1169 ret = component->driver->hw_params(component,
1172 return soc_component_ret(component, ret);
1174 /* mark substream if succeeded */
1175 soc_component_mark_push(component, substream, hw_params);
1181 void snd_soc_pcm_component_hw_free(struct snd_pcm_substream *substream,
1184 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1185 struct snd_soc_component *component;
1188 for_each_rtd_components(rtd, i, component) {
1189 if (rollback && !soc_component_mark_match(component, substream, hw_params))
1192 if (component->driver->hw_free) {
1193 ret = component->driver->hw_free(component, substream);
1195 soc_component_ret(component, ret);
1198 /* remove marked substream */
1199 soc_component_mark_pop(component, substream, hw_params);
1203 static int soc_component_trigger(struct snd_soc_component *component,
1204 struct snd_pcm_substream *substream,
1209 if (component->driver->trigger)
1210 ret = component->driver->trigger(component, substream, cmd);
1212 return soc_component_ret(component, ret);
1215 int snd_soc_pcm_component_trigger(struct snd_pcm_substream *substream,
1216 int cmd, int rollback)
1218 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1219 struct snd_soc_component *component;
1223 case SNDRV_PCM_TRIGGER_START:
1224 case SNDRV_PCM_TRIGGER_RESUME:
1225 case SNDRV_PCM_TRIGGER_PAUSE_RELEASE:
1226 for_each_rtd_components(rtd, i, component) {
1227 ret = soc_component_trigger(component, substream, cmd);
1230 soc_component_mark_push(component, substream, trigger);
1233 case SNDRV_PCM_TRIGGER_STOP:
1234 case SNDRV_PCM_TRIGGER_SUSPEND:
1235 case SNDRV_PCM_TRIGGER_PAUSE_PUSH:
1236 for_each_rtd_components(rtd, i, component) {
1237 if (rollback && !soc_component_mark_match(component, substream, trigger))
1240 r = soc_component_trigger(component, substream, cmd);
1242 ret = r; /* use last ret */
1243 soc_component_mark_pop(component, substream, trigger);
1250 int snd_soc_pcm_component_pm_runtime_get(struct snd_soc_pcm_runtime *rtd,
1253 struct snd_soc_component *component;
1256 for_each_rtd_components(rtd, i, component) {
1257 int ret = pm_runtime_get_sync(component->dev);
1258 if (ret < 0 && ret != -EACCES) {
1259 pm_runtime_put_noidle(component->dev);
1260 return soc_component_ret(component, ret);
1262 /* mark stream if succeeded */
1263 soc_component_mark_push(component, stream, pm);
1269 void snd_soc_pcm_component_pm_runtime_put(struct snd_soc_pcm_runtime *rtd,
1270 void *stream, int rollback)
1272 struct snd_soc_component *component;
1275 for_each_rtd_components(rtd, i, component) {
1276 if (rollback && !soc_component_mark_match(component, stream, pm))
1279 pm_runtime_mark_last_busy(component->dev);
1280 pm_runtime_put_autosuspend(component->dev);
1282 /* remove marked stream */
1283 soc_component_mark_pop(component, stream, pm);
1287 int snd_soc_pcm_component_ack(struct snd_pcm_substream *substream)
1289 struct snd_soc_pcm_runtime *rtd = asoc_substream_to_rtd(substream);
1290 struct snd_soc_component *component;
1293 /* FIXME: use 1st pointer */
1294 for_each_rtd_components(rtd, i, component)
1295 if (component->driver->ack)
1296 return component->driver->ack(component, substream);