Commit | Line | Data |
---|---|---|
e2cfd2c9 KM |
1 | /* SPDX-License-Identifier: GPL-2.0 |
2 | * | |
a47cbe72 MB |
3 | * linux/sound/soc-dai.h -- ALSA SoC Layer |
4 | * | |
5 | * Copyright: 2005-2008 Wolfson Microelectronics. PLC. | |
6 | * | |
a47cbe72 MB |
7 | * Digital Audio Interface (DAI) API. |
8 | */ | |
9 | ||
10 | #ifndef __LINUX_SND_SOC_DAI_H | |
11 | #define __LINUX_SND_SOC_DAI_H | |
12 | ||
13 | ||
14 | #include <linux/list.h> | |
d2e3cb85 | 15 | #include <sound/asoc.h> |
a47cbe72 MB |
16 | |
17 | struct snd_pcm_substream; | |
888df395 | 18 | struct snd_soc_dapm_widget; |
49681077 | 19 | struct snd_compr_stream; |
a47cbe72 MB |
20 | |
21 | /* | |
22 | * DAI hardware audio formats. | |
23 | * | |
24 | * Describes the physical PCM data formating and clocking. Add new formats | |
25 | * to the end. | |
26 | */ | |
d2e3cb85 ML |
27 | #define SND_SOC_DAIFMT_I2S SND_SOC_DAI_FORMAT_I2S |
28 | #define SND_SOC_DAIFMT_RIGHT_J SND_SOC_DAI_FORMAT_RIGHT_J | |
29 | #define SND_SOC_DAIFMT_LEFT_J SND_SOC_DAI_FORMAT_LEFT_J | |
30 | #define SND_SOC_DAIFMT_DSP_A SND_SOC_DAI_FORMAT_DSP_A | |
31 | #define SND_SOC_DAIFMT_DSP_B SND_SOC_DAI_FORMAT_DSP_B | |
32 | #define SND_SOC_DAIFMT_AC97 SND_SOC_DAI_FORMAT_AC97 | |
33 | #define SND_SOC_DAIFMT_PDM SND_SOC_DAI_FORMAT_PDM | |
a47cbe72 MB |
34 | |
35 | /* left and right justified also known as MSB and LSB respectively */ | |
36 | #define SND_SOC_DAIFMT_MSB SND_SOC_DAIFMT_LEFT_J | |
37 | #define SND_SOC_DAIFMT_LSB SND_SOC_DAIFMT_RIGHT_J | |
38 | ||
ba9e82a1 KM |
39 | /* Describes the possible PCM format */ |
40 | /* | |
41 | * use SND_SOC_DAI_FORMAT_xx as eash shift. | |
42 | * see | |
43 | * snd_soc_runtime_get_dai_fmt() | |
44 | */ | |
45 | #define SND_SOC_POSSIBLE_DAIFMT_FORMAT_SHIFT 0 | |
46 | #define SND_SOC_POSSIBLE_DAIFMT_FORMAT_MASK (0xFFFF << SND_SOC_POSSIBLE_DAIFMT_FORMAT_SHIFT) | |
47 | #define SND_SOC_POSSIBLE_DAIFMT_I2S (1 << SND_SOC_DAI_FORMAT_I2S) | |
48 | #define SND_SOC_POSSIBLE_DAIFMT_RIGHT_J (1 << SND_SOC_DAI_FORMAT_RIGHT_J) | |
49 | #define SND_SOC_POSSIBLE_DAIFMT_LEFT_J (1 << SND_SOC_DAI_FORMAT_LEFT_J) | |
50 | #define SND_SOC_POSSIBLE_DAIFMT_DSP_A (1 << SND_SOC_DAI_FORMAT_DSP_A) | |
51 | #define SND_SOC_POSSIBLE_DAIFMT_DSP_B (1 << SND_SOC_DAI_FORMAT_DSP_B) | |
52 | #define SND_SOC_POSSIBLE_DAIFMT_AC97 (1 << SND_SOC_DAI_FORMAT_AC97) | |
53 | #define SND_SOC_POSSIBLE_DAIFMT_PDM (1 << SND_SOC_DAI_FORMAT_PDM) | |
54 | ||
a47cbe72 MB |
55 | /* |
56 | * DAI Clock gating. | |
57 | * | |
fc926a7c | 58 | * DAI bit clocks can be gated (disabled) when the DAI is not |
a47cbe72 MB |
59 | * sending or receiving PCM data in a frame. This can be used to save power. |
60 | */ | |
75d9ac46 | 61 | #define SND_SOC_DAIFMT_CONT (1 << 4) /* continuous clock */ |
eef28e10 | 62 | #define SND_SOC_DAIFMT_GATED (0 << 4) /* clock is gated */ |
a47cbe72 | 63 | |
ba9e82a1 KM |
64 | /* Describes the possible PCM format */ |
65 | /* | |
66 | * define GATED -> CONT. GATED will be selected if both are selected. | |
67 | * see | |
68 | * snd_soc_runtime_get_dai_fmt() | |
69 | */ | |
70 | #define SND_SOC_POSSIBLE_DAIFMT_CLOCK_SHIFT 16 | |
71 | #define SND_SOC_POSSIBLE_DAIFMT_CLOCK_MASK (0xFFFF << SND_SOC_POSSIBLE_DAIFMT_CLOCK_SHIFT) | |
72 | #define SND_SOC_POSSIBLE_DAIFMT_GATED (0x1ULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_SHIFT) | |
73 | #define SND_SOC_POSSIBLE_DAIFMT_CONT (0x2ULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_SHIFT) | |
74 | ||
a47cbe72 | 75 | /* |
1d387a3f | 76 | * DAI hardware signal polarity. |
a47cbe72 MB |
77 | * |
78 | * Specifies whether the DAI can also support inverted clocks for the specified | |
79 | * format. | |
1d387a3f AP |
80 | * |
81 | * BCLK: | |
82 | * - "normal" polarity means signal is available at rising edge of BCLK | |
83 | * - "inverted" polarity means signal is available at falling edge of BCLK | |
84 | * | |
85 | * FSYNC "normal" polarity depends on the frame format: | |
86 | * - I2S: frame consists of left then right channel data. Left channel starts | |
87 | * with falling FSYNC edge, right channel starts with rising FSYNC edge. | |
88 | * - Left/Right Justified: frame consists of left then right channel data. | |
89 | * Left channel starts with rising FSYNC edge, right channel starts with | |
90 | * falling FSYNC edge. | |
91 | * - DSP A/B: Frame starts with rising FSYNC edge. | |
92 | * - AC97: Frame starts with rising FSYNC edge. | |
93 | * | |
94 | * "Negative" FSYNC polarity is the one opposite of "normal" polarity. | |
a47cbe72 | 95 | */ |
5d163336 | 96 | #define SND_SOC_DAIFMT_NB_NF (0 << 8) /* normal bit clock + frame */ |
75d9ac46 MB |
97 | #define SND_SOC_DAIFMT_NB_IF (2 << 8) /* normal BCLK + inv FRM */ |
98 | #define SND_SOC_DAIFMT_IB_NF (3 << 8) /* invert BCLK + nor FRM */ | |
99 | #define SND_SOC_DAIFMT_IB_IF (4 << 8) /* invert BCLK + FRM */ | |
a47cbe72 | 100 | |
ba9e82a1 KM |
101 | /* Describes the possible PCM format */ |
102 | #define SND_SOC_POSSIBLE_DAIFMT_INV_SHIFT 32 | |
103 | #define SND_SOC_POSSIBLE_DAIFMT_INV_MASK (0xFFFFULL << SND_SOC_POSSIBLE_DAIFMT_INV_SHIFT) | |
104 | #define SND_SOC_POSSIBLE_DAIFMT_NB_NF (0x1ULL << SND_SOC_POSSIBLE_DAIFMT_INV_SHIFT) | |
105 | #define SND_SOC_POSSIBLE_DAIFMT_NB_IF (0x2ULL << SND_SOC_POSSIBLE_DAIFMT_INV_SHIFT) | |
106 | #define SND_SOC_POSSIBLE_DAIFMT_IB_NF (0x4ULL << SND_SOC_POSSIBLE_DAIFMT_INV_SHIFT) | |
107 | #define SND_SOC_POSSIBLE_DAIFMT_IB_IF (0x8ULL << SND_SOC_POSSIBLE_DAIFMT_INV_SHIFT) | |
108 | ||
a47cbe72 | 109 | /* |
f026c123 | 110 | * DAI hardware clock providers/consumers |
a47cbe72 MB |
111 | * |
112 | * This is wrt the codec, the inverse is true for the interface | |
f026c123 PLB |
113 | * i.e. if the codec is clk and FRM provider then the interface is |
114 | * clk and frame consumer. | |
a47cbe72 | 115 | */ |
f026c123 PLB |
116 | #define SND_SOC_DAIFMT_CBP_CFP (1 << 12) /* codec clk provider & frame provider */ |
117 | #define SND_SOC_DAIFMT_CBC_CFP (2 << 12) /* codec clk consumer & frame provider */ | |
118 | #define SND_SOC_DAIFMT_CBP_CFC (3 << 12) /* codec clk provider & frame consumer */ | |
47c11316 | 119 | #define SND_SOC_DAIFMT_CBC_CFC (4 << 12) /* codec clk consumer & frame consumer */ |
f026c123 PLB |
120 | |
121 | /* previous definitions kept for backwards-compatibility, do not use in new contributions */ | |
122 | #define SND_SOC_DAIFMT_CBM_CFM SND_SOC_DAIFMT_CBP_CFP | |
123 | #define SND_SOC_DAIFMT_CBS_CFM SND_SOC_DAIFMT_CBC_CFP | |
124 | #define SND_SOC_DAIFMT_CBM_CFS SND_SOC_DAIFMT_CBP_CFC | |
125 | #define SND_SOC_DAIFMT_CBS_CFS SND_SOC_DAIFMT_CBC_CFC | |
126 | ||
ba9e82a1 KM |
127 | /* Describes the possible PCM format */ |
128 | #define SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_SHIFT 48 | |
129 | #define SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_MASK (0xFFFFULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_SHIFT) | |
130 | #define SND_SOC_POSSIBLE_DAIFMT_CBP_CFP (0x1ULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_SHIFT) | |
131 | #define SND_SOC_POSSIBLE_DAIFMT_CBC_CFP (0x2ULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_SHIFT) | |
132 | #define SND_SOC_POSSIBLE_DAIFMT_CBP_CFC (0x4ULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_SHIFT) | |
133 | #define SND_SOC_POSSIBLE_DAIFMT_CBC_CFC (0x8ULL << SND_SOC_POSSIBLE_DAIFMT_CLOCK_PROVIDER_SHIFT) | |
134 | ||
f026c123 PLB |
135 | #define SND_SOC_DAIFMT_FORMAT_MASK 0x000f |
136 | #define SND_SOC_DAIFMT_CLOCK_MASK 0x00f0 | |
137 | #define SND_SOC_DAIFMT_INV_MASK 0x0f00 | |
138 | #define SND_SOC_DAIFMT_CLOCK_PROVIDER_MASK 0xf000 | |
139 | ||
140 | #define SND_SOC_DAIFMT_MASTER_MASK SND_SOC_DAIFMT_CLOCK_PROVIDER_MASK | |
a47cbe72 MB |
141 | |
142 | /* | |
143 | * Master Clock Directions | |
144 | */ | |
145 | #define SND_SOC_CLOCK_IN 0 | |
146 | #define SND_SOC_CLOCK_OUT 1 | |
147 | ||
8f738d58 MB |
148 | #define SND_SOC_STD_AC97_FMTS (SNDRV_PCM_FMTBIT_S8 |\ |
149 | SNDRV_PCM_FMTBIT_S16_LE |\ | |
150 | SNDRV_PCM_FMTBIT_S16_BE |\ | |
151 | SNDRV_PCM_FMTBIT_S20_3LE |\ | |
152 | SNDRV_PCM_FMTBIT_S20_3BE |\ | |
823dbb6e MS |
153 | SNDRV_PCM_FMTBIT_S20_LE |\ |
154 | SNDRV_PCM_FMTBIT_S20_BE |\ | |
8f738d58 MB |
155 | SNDRV_PCM_FMTBIT_S24_3LE |\ |
156 | SNDRV_PCM_FMTBIT_S24_3BE |\ | |
d34c4307 JS |
157 | SNDRV_PCM_FMTBIT_S32_LE |\ |
158 | SNDRV_PCM_FMTBIT_S32_BE) | |
33f503c9 | 159 | |
f0fba2ad | 160 | struct snd_soc_dai_driver; |
a47cbe72 MB |
161 | struct snd_soc_dai; |
162 | struct snd_ac97_bus_ops; | |
163 | ||
164 | /* Digital Audio Interface clocking API.*/ | |
165 | int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id, | |
166 | unsigned int freq, int dir); | |
167 | ||
168 | int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai, | |
169 | int div_id, int div); | |
170 | ||
171 | int snd_soc_dai_set_pll(struct snd_soc_dai *dai, | |
85488037 | 172 | int pll_id, int source, unsigned int freq_in, unsigned int freq_out); |
a47cbe72 | 173 | |
e54cf76b LG |
174 | int snd_soc_dai_set_bclk_ratio(struct snd_soc_dai *dai, unsigned int ratio); |
175 | ||
a47cbe72 | 176 | /* Digital Audio interface formatting */ |
ba9e82a1 KM |
177 | int snd_soc_dai_get_fmt_max_priority(struct snd_soc_pcm_runtime *rtd); |
178 | u64 snd_soc_dai_get_fmt(struct snd_soc_dai *dai, int priority); | |
a47cbe72 MB |
179 | int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt); |
180 | ||
181 | int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai, | |
a5479e38 | 182 | unsigned int tx_mask, unsigned int rx_mask, int slots, int slot_width); |
a47cbe72 | 183 | |
472df3cb BS |
184 | int snd_soc_dai_set_channel_map(struct snd_soc_dai *dai, |
185 | unsigned int tx_num, unsigned int *tx_slot, | |
186 | unsigned int rx_num, unsigned int *rx_slot); | |
187 | ||
a47cbe72 MB |
188 | int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate); |
189 | ||
190 | /* Digital Audio Interface mute */ | |
da18396f MB |
191 | int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute, |
192 | int direction); | |
a47cbe72 | 193 | |
467b061f SK |
194 | |
195 | int snd_soc_dai_get_channel_map(struct snd_soc_dai *dai, | |
196 | unsigned int *tx_num, unsigned int *tx_slot, | |
197 | unsigned int *rx_num, unsigned int *rx_slot); | |
198 | ||
bece9e95 LG |
199 | int snd_soc_dai_is_dummy(struct snd_soc_dai *dai); |
200 | ||
aa6166c2 KM |
201 | int snd_soc_dai_hw_params(struct snd_soc_dai *dai, |
202 | struct snd_pcm_substream *substream, | |
203 | struct snd_pcm_hw_params *params); | |
846faaed | 204 | void snd_soc_dai_hw_free(struct snd_soc_dai *dai, |
c304c9ac KM |
205 | struct snd_pcm_substream *substream, |
206 | int rollback); | |
5a52a045 KM |
207 | int snd_soc_dai_startup(struct snd_soc_dai *dai, |
208 | struct snd_pcm_substream *substream); | |
330fcb51 | 209 | void snd_soc_dai_shutdown(struct snd_soc_dai *dai, |
00a0b46c | 210 | struct snd_pcm_substream *substream, int rollback); |
1dea80d4 KM |
211 | snd_pcm_sframes_t snd_soc_dai_delay(struct snd_soc_dai *dai, |
212 | struct snd_pcm_substream *substream); | |
e0f22622 | 213 | void snd_soc_dai_suspend(struct snd_soc_dai *dai); |
24b09d05 | 214 | void snd_soc_dai_resume(struct snd_soc_dai *dai); |
b423c420 KM |
215 | int snd_soc_dai_compress_new(struct snd_soc_dai *dai, |
216 | struct snd_soc_pcm_runtime *rtd, int num); | |
467fece8 | 217 | bool snd_soc_dai_stream_valid(struct snd_soc_dai *dai, int stream); |
25612477 | 218 | void snd_soc_dai_link_set_capabilities(struct snd_soc_dai_link *dai_link); |
dc829106 KM |
219 | void snd_soc_dai_action(struct snd_soc_dai *dai, |
220 | int stream, int action); | |
221 | static inline void snd_soc_dai_activate(struct snd_soc_dai *dai, | |
222 | int stream) | |
223 | { | |
224 | snd_soc_dai_action(dai, stream, 1); | |
225 | } | |
226 | static inline void snd_soc_dai_deactivate(struct snd_soc_dai *dai, | |
227 | int stream) | |
228 | { | |
229 | snd_soc_dai_action(dai, stream, -1); | |
230 | } | |
efffd9b3 | 231 | int snd_soc_dai_active(struct snd_soc_dai *dai); |
aa6166c2 | 232 | |
51801aea | 233 | int snd_soc_pcm_dai_probe(struct snd_soc_pcm_runtime *rtd, int order); |
7eaa313b | 234 | int snd_soc_pcm_dai_remove(struct snd_soc_pcm_runtime *rtd, int order); |
0b73ba55 | 235 | int snd_soc_pcm_dai_new(struct snd_soc_pcm_runtime *rtd); |
d108c7fd | 236 | int snd_soc_pcm_dai_prepare(struct snd_pcm_substream *substream); |
6374f493 KM |
237 | int snd_soc_pcm_dai_trigger(struct snd_pcm_substream *substream, int cmd, |
238 | int rollback); | |
30819358 KM |
239 | int snd_soc_pcm_dai_bespoke_trigger(struct snd_pcm_substream *substream, |
240 | int cmd); | |
0b73ba55 | 241 | |
b5ae4cce KM |
242 | int snd_soc_dai_compr_startup(struct snd_soc_dai *dai, |
243 | struct snd_compr_stream *cstream); | |
2b25f81d | 244 | void snd_soc_dai_compr_shutdown(struct snd_soc_dai *dai, |
1e6a93cf KM |
245 | struct snd_compr_stream *cstream, |
246 | int rollback); | |
eb08411b KM |
247 | int snd_soc_dai_compr_trigger(struct snd_soc_dai *dai, |
248 | struct snd_compr_stream *cstream, int cmd); | |
8dfedafb KM |
249 | int snd_soc_dai_compr_set_params(struct snd_soc_dai *dai, |
250 | struct snd_compr_stream *cstream, | |
251 | struct snd_compr_params *params); | |
adbef543 KM |
252 | int snd_soc_dai_compr_get_params(struct snd_soc_dai *dai, |
253 | struct snd_compr_stream *cstream, | |
254 | struct snd_codec *params); | |
53294353 KM |
255 | int snd_soc_dai_compr_ack(struct snd_soc_dai *dai, |
256 | struct snd_compr_stream *cstream, | |
257 | size_t bytes); | |
ed38cc59 KM |
258 | int snd_soc_dai_compr_pointer(struct snd_soc_dai *dai, |
259 | struct snd_compr_stream *cstream, | |
260 | struct snd_compr_tstamp *tstamp); | |
88b3a7df KM |
261 | int snd_soc_dai_compr_set_metadata(struct snd_soc_dai *dai, |
262 | struct snd_compr_stream *cstream, | |
263 | struct snd_compr_metadata *metadata); | |
94d72819 KM |
264 | int snd_soc_dai_compr_get_metadata(struct snd_soc_dai *dai, |
265 | struct snd_compr_stream *cstream, | |
266 | struct snd_compr_metadata *metadata); | |
b5ae4cce | 267 | |
a47cbe72 MB |
268 | struct snd_soc_dai_ops { |
269 | /* | |
270 | * DAI clocking configuration, all optional. | |
271 | * Called by soc_card drivers, normally in their hw_params. | |
272 | */ | |
273 | int (*set_sysclk)(struct snd_soc_dai *dai, | |
274 | int clk_id, unsigned int freq, int dir); | |
85488037 MB |
275 | int (*set_pll)(struct snd_soc_dai *dai, int pll_id, int source, |
276 | unsigned int freq_in, unsigned int freq_out); | |
a47cbe72 | 277 | int (*set_clkdiv)(struct snd_soc_dai *dai, int div_id, int div); |
e54cf76b | 278 | int (*set_bclk_ratio)(struct snd_soc_dai *dai, unsigned int ratio); |
a47cbe72 MB |
279 | |
280 | /* | |
281 | * DAI format configuration | |
282 | * Called by soc_card drivers, normally in their hw_params. | |
283 | */ | |
284 | int (*set_fmt)(struct snd_soc_dai *dai, unsigned int fmt); | |
e5c21514 | 285 | int (*xlate_tdm_slot_mask)(unsigned int slots, |
89c67857 | 286 | unsigned int *tx_mask, unsigned int *rx_mask); |
a47cbe72 | 287 | int (*set_tdm_slot)(struct snd_soc_dai *dai, |
a5479e38 DR |
288 | unsigned int tx_mask, unsigned int rx_mask, |
289 | int slots, int slot_width); | |
472df3cb BS |
290 | int (*set_channel_map)(struct snd_soc_dai *dai, |
291 | unsigned int tx_num, unsigned int *tx_slot, | |
292 | unsigned int rx_num, unsigned int *rx_slot); | |
467b061f SK |
293 | int (*get_channel_map)(struct snd_soc_dai *dai, |
294 | unsigned int *tx_num, unsigned int *tx_slot, | |
295 | unsigned int *rx_num, unsigned int *rx_slot); | |
a47cbe72 MB |
296 | int (*set_tristate)(struct snd_soc_dai *dai, int tristate); |
297 | ||
97349b60 SN |
298 | int (*set_sdw_stream)(struct snd_soc_dai *dai, |
299 | void *stream, int direction); | |
36d73c4a PLB |
300 | void *(*get_sdw_stream)(struct snd_soc_dai *dai, int direction); |
301 | ||
a47cbe72 MB |
302 | /* |
303 | * DAI digital mute - optional. | |
304 | * Called by soc-core to minimise any pops. | |
305 | */ | |
da18396f | 306 | int (*mute_stream)(struct snd_soc_dai *dai, int mute, int stream); |
dee89c4d MB |
307 | |
308 | /* | |
309 | * ALSA PCM audio operations - all optional. | |
310 | * Called by soc-core during audio PCM operations. | |
311 | */ | |
312 | int (*startup)(struct snd_pcm_substream *, | |
313 | struct snd_soc_dai *); | |
314 | void (*shutdown)(struct snd_pcm_substream *, | |
315 | struct snd_soc_dai *); | |
316 | int (*hw_params)(struct snd_pcm_substream *, | |
317 | struct snd_pcm_hw_params *, struct snd_soc_dai *); | |
318 | int (*hw_free)(struct snd_pcm_substream *, | |
319 | struct snd_soc_dai *); | |
320 | int (*prepare)(struct snd_pcm_substream *, | |
321 | struct snd_soc_dai *); | |
9f1614aa MP |
322 | /* |
323 | * NOTE: Commands passed to the trigger function are not necessarily | |
324 | * compatible with the current state of the dai. For example this | |
325 | * sequence of commands is possible: START STOP STOP. | |
326 | * So do not unconditionally use refcounting functions in the trigger | |
327 | * function, e.g. clk_enable/disable. | |
328 | */ | |
dee89c4d MB |
329 | int (*trigger)(struct snd_pcm_substream *, int, |
330 | struct snd_soc_dai *); | |
07bf84aa LG |
331 | int (*bespoke_trigger)(struct snd_pcm_substream *, int, |
332 | struct snd_soc_dai *); | |
258020d0 PU |
333 | /* |
334 | * For hardware based FIFO caused delay reporting. | |
335 | * Optional. | |
336 | */ | |
337 | snd_pcm_sframes_t (*delay)(struct snd_pcm_substream *, | |
338 | struct snd_soc_dai *); | |
350d9935 | 339 | |
ba9e82a1 KM |
340 | /* |
341 | * Format list for auto selection. | |
342 | * Format will be increased if priority format was | |
343 | * not selected. | |
344 | * see | |
345 | * snd_soc_dai_get_fmt() | |
346 | */ | |
347 | u64 *auto_selectable_formats; | |
348 | int num_auto_selectable_formats; | |
349 | ||
350d9935 KM |
350 | /* bit field */ |
351 | unsigned int no_capture_mute:1; | |
a47cbe72 MB |
352 | }; |
353 | ||
2e622ae4 VK |
354 | struct snd_soc_cdai_ops { |
355 | /* | |
356 | * for compress ops | |
357 | */ | |
358 | int (*startup)(struct snd_compr_stream *, | |
359 | struct snd_soc_dai *); | |
360 | int (*shutdown)(struct snd_compr_stream *, | |
361 | struct snd_soc_dai *); | |
362 | int (*set_params)(struct snd_compr_stream *, | |
363 | struct snd_compr_params *, struct snd_soc_dai *); | |
364 | int (*get_params)(struct snd_compr_stream *, | |
365 | struct snd_codec *, struct snd_soc_dai *); | |
366 | int (*set_metadata)(struct snd_compr_stream *, | |
367 | struct snd_compr_metadata *, struct snd_soc_dai *); | |
368 | int (*get_metadata)(struct snd_compr_stream *, | |
369 | struct snd_compr_metadata *, struct snd_soc_dai *); | |
370 | int (*trigger)(struct snd_compr_stream *, int, | |
371 | struct snd_soc_dai *); | |
372 | int (*pointer)(struct snd_compr_stream *, | |
373 | struct snd_compr_tstamp *, struct snd_soc_dai *); | |
374 | int (*ack)(struct snd_compr_stream *, size_t, | |
375 | struct snd_soc_dai *); | |
376 | }; | |
377 | ||
a47cbe72 | 378 | /* |
f0fba2ad | 379 | * Digital Audio Interface Driver. |
a47cbe72 | 380 | * |
f0fba2ad LG |
381 | * Describes the Digital Audio Interface in terms of its ALSA, DAI and AC97 |
382 | * operations and capabilities. Codec and platform drivers will register this | |
383 | * structure for every DAI they have. | |
384 | * | |
385 | * This structure covers the clocking, formating and ALSA operations for each | |
386 | * interface. | |
a47cbe72 | 387 | */ |
f0fba2ad | 388 | struct snd_soc_dai_driver { |
a47cbe72 | 389 | /* DAI description */ |
f0fba2ad | 390 | const char *name; |
a47cbe72 | 391 | unsigned int id; |
62368294 | 392 | unsigned int base; |
68003e6c | 393 | struct snd_soc_dobj dobj; |
a47cbe72 | 394 | |
f0fba2ad LG |
395 | /* DAI driver callbacks */ |
396 | int (*probe)(struct snd_soc_dai *dai); | |
397 | int (*remove)(struct snd_soc_dai *dai); | |
49681077 | 398 | /* compress dai */ |
6f0c4226 | 399 | int (*compress_new)(struct snd_soc_pcm_runtime *rtd, int num); |
25f7b701 AP |
400 | /* Optional Callback used at pcm creation*/ |
401 | int (*pcm_new)(struct snd_soc_pcm_runtime *rtd, | |
402 | struct snd_soc_dai *dai); | |
a47cbe72 MB |
403 | |
404 | /* ops */ | |
1ee46ebd | 405 | const struct snd_soc_dai_ops *ops; |
2e622ae4 | 406 | const struct snd_soc_cdai_ops *cops; |
a47cbe72 MB |
407 | |
408 | /* DAI capabilities */ | |
409 | struct snd_soc_pcm_stream capture; | |
410 | struct snd_soc_pcm_stream playback; | |
f14654dd | 411 | unsigned int symmetric_rate:1; |
3635bf09 | 412 | unsigned int symmetric_channels:1; |
f14654dd | 413 | unsigned int symmetric_sample_bits:1; |
0168bf0d LG |
414 | |
415 | /* probe ordering - for components with runtime dependencies */ | |
416 | int probe_order; | |
417 | int remove_order; | |
f0fba2ad LG |
418 | }; |
419 | ||
420 | /* | |
421 | * Digital Audio Interface runtime data. | |
422 | * | |
423 | * Holds runtime data for a DAI. | |
424 | */ | |
425 | struct snd_soc_dai { | |
426 | const char *name; | |
427 | int id; | |
428 | struct device *dev; | |
f0fba2ad LG |
429 | |
430 | /* driver ops */ | |
431 | struct snd_soc_dai_driver *driver; | |
a47cbe72 MB |
432 | |
433 | /* DAI runtime info */ | |
0f6011fd | 434 | unsigned int stream_active[SNDRV_PCM_STREAM_LAST + 1]; /* usage count */ |
39b2238e | 435 | |
888df395 MB |
436 | struct snd_soc_dapm_widget *playback_widget; |
437 | struct snd_soc_dapm_widget *capture_widget; | |
438 | ||
f0fba2ad LG |
439 | /* DAI DMA data */ |
440 | void *playback_dma_data; | |
441 | void *capture_dma_data; | |
a47cbe72 | 442 | |
17841020 DA |
443 | /* Symmetry data - only valid if symmetry is being enforced */ |
444 | unsigned int rate; | |
3635bf09 NC |
445 | unsigned int channels; |
446 | unsigned int sample_bits; | |
17841020 | 447 | |
f0fba2ad | 448 | /* parent platform/codec */ |
6106d129 | 449 | struct snd_soc_component *component; |
2466ab97 | 450 | |
88bd870f BC |
451 | /* CODEC TDM slot masks and params (for fixup) */ |
452 | unsigned int tx_mask; | |
453 | unsigned int rx_mask; | |
454 | ||
a47cbe72 | 455 | struct list_head list; |
b56be800 | 456 | |
00a0b46c KM |
457 | /* function mark */ |
458 | struct snd_pcm_substream *mark_startup; | |
c304c9ac | 459 | struct snd_pcm_substream *mark_hw_params; |
6374f493 | 460 | struct snd_pcm_substream *mark_trigger; |
1e6a93cf | 461 | struct snd_compr_stream *mark_compr_startup; |
00a0b46c | 462 | |
b56be800 KM |
463 | /* bit field */ |
464 | unsigned int probed:1; | |
a47cbe72 MB |
465 | }; |
466 | ||
acf253c1 KM |
467 | static inline struct snd_soc_pcm_stream * |
468 | snd_soc_dai_get_pcm_stream(const struct snd_soc_dai *dai, int stream) | |
469 | { | |
470 | return (stream == SNDRV_PCM_STREAM_PLAYBACK) ? | |
471 | &dai->driver->playback : &dai->driver->capture; | |
472 | } | |
473 | ||
0c01f6ca KM |
474 | static inline |
475 | struct snd_soc_dapm_widget *snd_soc_dai_get_widget( | |
476 | struct snd_soc_dai *dai, int stream) | |
477 | { | |
478 | return (stream == SNDRV_PCM_STREAM_PLAYBACK) ? | |
479 | dai->playback_widget : dai->capture_widget; | |
480 | } | |
481 | ||
fd23b7de DM |
482 | static inline void *snd_soc_dai_get_dma_data(const struct snd_soc_dai *dai, |
483 | const struct snd_pcm_substream *ss) | |
484 | { | |
485 | return (ss->stream == SNDRV_PCM_STREAM_PLAYBACK) ? | |
f0fba2ad | 486 | dai->playback_dma_data : dai->capture_dma_data; |
fd23b7de DM |
487 | } |
488 | ||
489 | static inline void snd_soc_dai_set_dma_data(struct snd_soc_dai *dai, | |
490 | const struct snd_pcm_substream *ss, | |
491 | void *data) | |
492 | { | |
493 | if (ss->stream == SNDRV_PCM_STREAM_PLAYBACK) | |
f0fba2ad | 494 | dai->playback_dma_data = data; |
fd23b7de | 495 | else |
f0fba2ad LG |
496 | dai->capture_dma_data = data; |
497 | } | |
498 | ||
ecfc0c04 MB |
499 | static inline void snd_soc_dai_init_dma_data(struct snd_soc_dai *dai, |
500 | void *playback, void *capture) | |
501 | { | |
502 | dai->playback_dma_data = playback; | |
503 | dai->capture_dma_data = capture; | |
504 | } | |
505 | ||
f0fba2ad LG |
506 | static inline void snd_soc_dai_set_drvdata(struct snd_soc_dai *dai, |
507 | void *data) | |
508 | { | |
509 | dev_set_drvdata(dai->dev, data); | |
510 | } | |
511 | ||
512 | static inline void *snd_soc_dai_get_drvdata(struct snd_soc_dai *dai) | |
513 | { | |
514 | return dev_get_drvdata(dai->dev); | |
fd23b7de DM |
515 | } |
516 | ||
97349b60 SN |
517 | /** |
518 | * snd_soc_dai_set_sdw_stream() - Configures a DAI for SDW stream operation | |
519 | * @dai: DAI | |
520 | * @stream: STREAM | |
521 | * @direction: Stream direction(Playback/Capture) | |
522 | * SoundWire subsystem doesn't have a notion of direction and we reuse | |
523 | * the ASoC stream direction to configure sink/source ports. | |
524 | * Playback maps to source ports and Capture for sink ports. | |
525 | * | |
526 | * This should be invoked with NULL to clear the stream set previously. | |
527 | * Returns 0 on success, a negative error code otherwise. | |
528 | */ | |
529 | static inline int snd_soc_dai_set_sdw_stream(struct snd_soc_dai *dai, | |
530 | void *stream, int direction) | |
531 | { | |
532 | if (dai->driver->ops->set_sdw_stream) | |
533 | return dai->driver->ops->set_sdw_stream(dai, stream, direction); | |
534 | else | |
535 | return -ENOTSUPP; | |
536 | } | |
537 | ||
36d73c4a PLB |
538 | /** |
539 | * snd_soc_dai_get_sdw_stream() - Retrieves SDW stream from DAI | |
540 | * @dai: DAI | |
541 | * @direction: Stream direction(Playback/Capture) | |
542 | * | |
543 | * This routine only retrieves that was previously configured | |
544 | * with snd_soc_dai_get_sdw_stream() | |
545 | * | |
d20e834e PLB |
546 | * Returns pointer to stream or an ERR_PTR value, e.g. |
547 | * ERR_PTR(-ENOTSUPP) if callback is not supported; | |
36d73c4a PLB |
548 | */ |
549 | static inline void *snd_soc_dai_get_sdw_stream(struct snd_soc_dai *dai, | |
550 | int direction) | |
551 | { | |
552 | if (dai->driver->ops->get_sdw_stream) | |
553 | return dai->driver->ops->get_sdw_stream(dai, direction); | |
554 | else | |
308811a3 | 555 | return ERR_PTR(-ENOTSUPP); |
36d73c4a PLB |
556 | } |
557 | ||
5552f8d7 KM |
558 | static inline unsigned int |
559 | snd_soc_dai_stream_active(struct snd_soc_dai *dai, int stream) | |
560 | { | |
561 | return dai->stream_active[stream]; | |
562 | } | |
563 | ||
a47cbe72 | 564 | #endif |