Lines Matching +full:dai +full:- +full:format
1 /* SPDX-License-Identifier: GPL-2.0
3 * linux/sound/soc-dai.h -- ALSA SoC Layer
5 * Copyright: 2005-2008 Wolfson Microelectronics. PLC.
7 * Digital Audio Interface (DAI) API.
22 * DAI hardware audio formats.
39 /* Describes the possible PCM format */
56 * DAI Clock gating.
58 * DAI bit clocks can be gated (disabled) when the DAI is not
64 /* Describes the possible PCM format */
66 * define GATED -> CONT. GATED will be selected if both are selected.
76 * DAI hardware signal polarity.
78 * Specifies whether the DAI can also support inverted clocks for the specified
79 * format.
82 * - "normal" polarity means signal is available at rising edge of BCLK
83 * - "inverted" polarity means signal is available at falling edge of BCLK
85 * FSYNC "normal" polarity depends on the frame format:
86 * - I2S: frame consists of left then right channel data. Left channel starts
88 * - Left/Right Justified: frame consists of left then right channel data.
91 * - DSP A/B: Frame starts with rising FSYNC edge.
92 * - AC97: Frame starts with rising FSYNC edge.
101 /* Describes the possible PCM format */
110 * DAI hardware clock providers/consumers
127 /* Describes the possible PCM format */
165 int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id,
168 int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai,
171 int snd_soc_dai_set_pll(struct snd_soc_dai *dai,
174 int snd_soc_dai_set_bclk_ratio(struct snd_soc_dai *dai, unsigned int ratio);
178 u64 snd_soc_dai_get_fmt(const struct snd_soc_dai *dai, int priority);
179 int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt);
181 int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
184 int snd_soc_dai_set_channel_map(struct snd_soc_dai *dai,
188 int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate);
190 int snd_soc_dai_prepare(struct snd_soc_dai *dai,
194 int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute,
196 int snd_soc_dai_mute_is_ctrled_at_trigger(struct snd_soc_dai *dai);
198 int snd_soc_dai_get_channel_map(const struct snd_soc_dai *dai,
202 int snd_soc_dai_is_dummy(const struct snd_soc_dai *dai);
204 int snd_soc_dai_hw_params(struct snd_soc_dai *dai,
207 void snd_soc_dai_hw_free(struct snd_soc_dai *dai,
210 int snd_soc_dai_startup(struct snd_soc_dai *dai,
212 void snd_soc_dai_shutdown(struct snd_soc_dai *dai,
214 void snd_soc_dai_suspend(struct snd_soc_dai *dai);
215 void snd_soc_dai_resume(struct snd_soc_dai *dai);
216 int snd_soc_dai_compress_new(struct snd_soc_dai *dai, struct snd_soc_pcm_runtime *rtd);
217 bool snd_soc_dai_stream_valid(const struct snd_soc_dai *dai, int stream);
218 void snd_soc_dai_action(struct snd_soc_dai *dai,
220 static inline void snd_soc_dai_activate(struct snd_soc_dai *dai,
223 snd_soc_dai_action(dai, stream, 1);
225 static inline void snd_soc_dai_deactivate(struct snd_soc_dai *dai,
228 snd_soc_dai_action(dai, stream, -1);
230 int snd_soc_dai_active(const struct snd_soc_dai *dai);
241 int snd_soc_dai_compr_startup(struct snd_soc_dai *dai,
243 void snd_soc_dai_compr_shutdown(struct snd_soc_dai *dai,
246 int snd_soc_dai_compr_trigger(struct snd_soc_dai *dai,
248 int snd_soc_dai_compr_set_params(struct snd_soc_dai *dai,
251 int snd_soc_dai_compr_get_params(struct snd_soc_dai *dai,
254 int snd_soc_dai_compr_ack(struct snd_soc_dai *dai,
257 int snd_soc_dai_compr_pointer(struct snd_soc_dai *dai,
260 int snd_soc_dai_compr_set_metadata(struct snd_soc_dai *dai,
263 int snd_soc_dai_compr_get_metadata(struct snd_soc_dai *dai,
267 const char *snd_soc_dai_name_get(const struct snd_soc_dai *dai);
270 /* DAI driver callbacks */
271 int (*probe)(struct snd_soc_dai *dai);
272 int (*remove)(struct snd_soc_dai *dai);
273 /* compress dai */
277 struct snd_soc_dai *dai);
280 * DAI clocking configuration, all optional.
283 int (*set_sysclk)(struct snd_soc_dai *dai,
285 int (*set_pll)(struct snd_soc_dai *dai, int pll_id, int source,
287 int (*set_clkdiv)(struct snd_soc_dai *dai, int div_id, int div);
288 int (*set_bclk_ratio)(struct snd_soc_dai *dai, unsigned int ratio);
291 * DAI format configuration
294 int (*set_fmt)(struct snd_soc_dai *dai, unsigned int fmt);
297 int (*set_tdm_slot)(struct snd_soc_dai *dai,
300 int (*set_channel_map)(struct snd_soc_dai *dai,
303 int (*get_channel_map)(const struct snd_soc_dai *dai,
306 int (*set_tristate)(struct snd_soc_dai *dai, int tristate);
308 int (*set_stream)(struct snd_soc_dai *dai,
310 void *(*get_stream)(struct snd_soc_dai *dai, int direction);
313 * DAI digital mute - optional.
314 * Called by soc-core to minimise any pops.
316 int (*mute_stream)(struct snd_soc_dai *dai, int mute, int stream);
319 * ALSA PCM audio operations - all optional.
320 * Called by soc-core during audio PCM operations.
334 * compatible with the current state of the dai. For example this
350 * Format list for auto selection.
351 * Format will be increased if priority format was
359 /* probe ordering - for components with runtime dependencies */
388 struct snd_soc_dai *dai);
396 * Describes the Digital Audio Interface in terms of its ALSA, DAI and AC97
398 * structure for every DAI they have.
404 /* DAI description */
415 /* DAI capabilities */
430 void *dma_data; /* DAI DMA data */
436 * Holds runtime data for a DAI.
446 /* DAI runtime info */
449 /* Symmetry data - only valid if symmetry is being enforced */
468 /* DAI private data */
473 snd_soc_dai_get_pcm_stream(const struct snd_soc_dai *dai, int stream)
476 &dai->driver->playback : &dai->driver->capture;
479 #define snd_soc_dai_get_widget_playback(dai) snd_soc_dai_get_widget(dai, SNDRV_PCM_STREAM_PLAYBACK)
480 #define snd_soc_dai_get_widget_capture(dai) snd_soc_dai_get_widget(dai, SNDRV_PCM_STREAM_CAPTURE)
482 struct snd_soc_dapm_widget *snd_soc_dai_get_widget(struct snd_soc_dai *dai, int stream)
484 return dai->stream[stream].widget;
487 #define snd_soc_dai_set_widget_playback(dai, widget) snd_soc_dai_set_widget(dai, SNDRV_PCM_STREAM_PLAYBACK, widget)
488 #define snd_soc_dai_set_widget_capture(dai, widget) snd_soc_dai_set_widget(dai, SNDRV_PCM_STREAM_CAPTURE, widget)
490 void snd_soc_dai_set_widget(struct snd_soc_dai *dai, int stream, struct snd_soc_dapm_widget *widget)
492 dai->stream[stream].widget = widget;
495 #define snd_soc_dai_dma_data_get_playback(dai) snd_soc_dai_dma_data_get(dai, SNDRV_PCM_STREAM_PLAYBACK)
496 #define snd_soc_dai_dma_data_get_capture(dai) snd_soc_dai_dma_data_get(dai, SNDRV_PCM_STREAM_CAPTURE)
497 #define snd_soc_dai_get_dma_data(dai, ss) snd_soc_dai_dma_data_get(dai, ss->stream)
498 static inline void *snd_soc_dai_dma_data_get(const struct snd_soc_dai *dai, int stream)
500 return dai->stream[stream].dma_data;
503 #define snd_soc_dai_dma_data_set_playback(dai, data) snd_soc_dai_dma_data_set(dai, SNDRV_PCM_STREAM_PLAYBACK, data)
504 #define snd_soc_dai_dma_data_set_capture(dai, data) snd_soc_dai_dma_data_set(dai, SNDRV_PCM_STREAM_CAPTURE, data)
505 #define snd_soc_dai_set_dma_data(dai, ss, data) snd_soc_dai_dma_data_set(dai, ss->stream, data)
506 static inline void snd_soc_dai_dma_data_set(struct snd_soc_dai *dai, int stream, void *data)
508 dai->stream[stream].dma_data = data;
511 static inline void snd_soc_dai_init_dma_data(struct snd_soc_dai *dai, void *playback, void *capture)
513 snd_soc_dai_dma_data_set_playback(dai, playback);
514 snd_soc_dai_dma_data_set_capture(dai, capture);
517 static inline unsigned int snd_soc_dai_tdm_mask_get(const struct snd_soc_dai *dai,
520 return dai->stream[stream].tdm_mask;
523 static inline void snd_soc_dai_tdm_mask_set(struct snd_soc_dai *dai, int stream,
526 dai->stream[stream].tdm_mask = tdm_mask;
529 static inline unsigned int snd_soc_dai_stream_active(const struct snd_soc_dai *dai,
533 return dai->stream[stream].active;
536 static inline void snd_soc_dai_set_drvdata(struct snd_soc_dai *dai,
539 dev_set_drvdata(dai->dev, data);
542 static inline void *snd_soc_dai_get_drvdata(struct snd_soc_dai *dai)
544 return dev_get_drvdata(dai->dev);
548 * snd_soc_dai_set_stream() - Configures a DAI for stream operation
549 * @dai: DAI
550 * @stream: STREAM (opaque structure depending on DAI type)
559 static inline int snd_soc_dai_set_stream(struct snd_soc_dai *dai,
562 if (dai->driver->ops->set_stream)
563 return dai->driver->ops->set_stream(dai, stream, direction);
565 return -ENOTSUPP;
569 * snd_soc_dai_get_stream() - Retrieves stream from DAI
570 * @dai: DAI
577 * ERR_PTR(-ENOTSUPP) if callback is not supported;
579 static inline void *snd_soc_dai_get_stream(struct snd_soc_dai *dai,
582 if (dai->driver->ops->get_stream)
583 return dai->driver->ops->get_stream(dai, direction);
585 return ERR_PTR(-ENOTSUPP);