diff options
author | Mark Brown <broonie@opensource.wolfsonmicro.com> | 2008-07-23 09:03:07 -0400 |
---|---|---|
committer | Mark Brown <broonie@opensource.wolfsonmicro.com> | 2008-11-21 09:02:08 -0500 |
commit | a47cbe7263236691ee0bbc392f7fd4ec0da1159f (patch) | |
tree | 78b009a80c5c4bd625a3935ec621d5b5b2d42b74 /include/sound/soc.h | |
parent | 5de27b6cc0a8a1d27158ec9047cb5981745edfc0 (diff) |
ASoC: Move DAI structure definitions into new soc-dai.h
ASoC v2 factors most of the contents of soc.h out into separate headers,
including soc-dai.h for the DAI. Factor the existing DAI API out into
this file in order to prepare for backporting of the ASoC v2 DAI API.
Also backport some of Liam's improvements to the documentation.
Signed-off-by: Mark Brown <broonie@opensource.wolfsonmicro.com>
Diffstat (limited to 'include/sound/soc.h')
-rw-r--r-- | include/sound/soc.h | 148 |
1 files changed, 2 insertions, 146 deletions
diff --git a/include/sound/soc.h b/include/sound/soc.h index 3be17b3c650c..e4465f73aa46 100644 --- a/include/sound/soc.h +++ b/include/sound/soc.h | |||
@@ -151,76 +151,6 @@ enum snd_soc_bias_level { | |||
151 | #define SND_SOC_DAI_PCM 0x4 | 151 | #define SND_SOC_DAI_PCM 0x4 |
152 | #define SND_SOC_DAI_AC97_BUS 0x8 /* for custom i.e. non ac97_codec.c */ | 152 | #define SND_SOC_DAI_AC97_BUS 0x8 /* for custom i.e. non ac97_codec.c */ |
153 | 153 | ||
154 | /* | ||
155 | * DAI hardware audio formats | ||
156 | */ | ||
157 | #define SND_SOC_DAIFMT_I2S 0 /* I2S mode */ | ||
158 | #define SND_SOC_DAIFMT_RIGHT_J 1 /* Right justified mode */ | ||
159 | #define SND_SOC_DAIFMT_LEFT_J 2 /* Left Justified mode */ | ||
160 | #define SND_SOC_DAIFMT_DSP_A 3 /* L data msb after FRM or LRC */ | ||
161 | #define SND_SOC_DAIFMT_DSP_B 4 /* L data msb during FRM or LRC */ | ||
162 | #define SND_SOC_DAIFMT_AC97 5 /* AC97 */ | ||
163 | |||
164 | #define SND_SOC_DAIFMT_MSB SND_SOC_DAIFMT_LEFT_J | ||
165 | #define SND_SOC_DAIFMT_LSB SND_SOC_DAIFMT_RIGHT_J | ||
166 | |||
167 | /* | ||
168 | * DAI Gating | ||
169 | */ | ||
170 | #define SND_SOC_DAIFMT_CONT (0 << 4) /* continuous clock */ | ||
171 | #define SND_SOC_DAIFMT_GATED (1 << 4) /* clock is gated when not Tx/Rx */ | ||
172 | |||
173 | /* | ||
174 | * DAI Sync | ||
175 | * Synchronous LR (Left Right) clocks and Frame signals. | ||
176 | */ | ||
177 | #define SND_SOC_DAIFMT_SYNC (0 << 5) /* Tx FRM = Rx FRM */ | ||
178 | #define SND_SOC_DAIFMT_ASYNC (1 << 5) /* Tx FRM ~ Rx FRM */ | ||
179 | |||
180 | /* | ||
181 | * TDM | ||
182 | */ | ||
183 | #define SND_SOC_DAIFMT_TDM (1 << 6) | ||
184 | |||
185 | /* | ||
186 | * DAI hardware signal inversions | ||
187 | */ | ||
188 | #define SND_SOC_DAIFMT_NB_NF (0 << 8) /* normal bclk + frm */ | ||
189 | #define SND_SOC_DAIFMT_NB_IF (1 << 8) /* normal bclk + inv frm */ | ||
190 | #define SND_SOC_DAIFMT_IB_NF (2 << 8) /* invert bclk + nor frm */ | ||
191 | #define SND_SOC_DAIFMT_IB_IF (3 << 8) /* invert bclk + frm */ | ||
192 | |||
193 | /* | ||
194 | * DAI hardware clock masters | ||
195 | * This is wrt the codec, the inverse is true for the interface | ||
196 | * i.e. if the codec is clk and frm master then the interface is | ||
197 | * clk and frame slave. | ||
198 | */ | ||
199 | #define SND_SOC_DAIFMT_CBM_CFM (0 << 12) /* codec clk & frm master */ | ||
200 | #define SND_SOC_DAIFMT_CBS_CFM (1 << 12) /* codec clk slave & frm master */ | ||
201 | #define SND_SOC_DAIFMT_CBM_CFS (2 << 12) /* codec clk master & frame slave */ | ||
202 | #define SND_SOC_DAIFMT_CBS_CFS (3 << 12) /* codec clk & frm slave */ | ||
203 | |||
204 | #define SND_SOC_DAIFMT_FORMAT_MASK 0x000f | ||
205 | #define SND_SOC_DAIFMT_CLOCK_MASK 0x00f0 | ||
206 | #define SND_SOC_DAIFMT_INV_MASK 0x0f00 | ||
207 | #define SND_SOC_DAIFMT_MASTER_MASK 0xf000 | ||
208 | |||
209 | |||
210 | /* | ||
211 | * Master Clock Directions | ||
212 | */ | ||
213 | #define SND_SOC_CLOCK_IN 0 | ||
214 | #define SND_SOC_CLOCK_OUT 1 | ||
215 | |||
216 | /* | ||
217 | * AC97 codec ID's bitmask | ||
218 | */ | ||
219 | #define SND_SOC_DAI_AC97_ID0 (1 << 0) | ||
220 | #define SND_SOC_DAI_AC97_ID1 (1 << 1) | ||
221 | #define SND_SOC_DAI_AC97_ID2 (1 << 2) | ||
222 | #define SND_SOC_DAI_AC97_ID3 (1 << 3) | ||
223 | |||
224 | struct snd_soc_device; | 154 | struct snd_soc_device; |
225 | struct snd_soc_pcm_stream; | 155 | struct snd_soc_pcm_stream; |
226 | struct snd_soc_ops; | 156 | struct snd_soc_ops; |
@@ -260,27 +190,6 @@ int snd_soc_new_ac97_codec(struct snd_soc_codec *codec, | |||
260 | struct snd_ac97_bus_ops *ops, int num); | 190 | struct snd_ac97_bus_ops *ops, int num); |
261 | void snd_soc_free_ac97_codec(struct snd_soc_codec *codec); | 191 | void snd_soc_free_ac97_codec(struct snd_soc_codec *codec); |
262 | 192 | ||
263 | /* Digital Audio Interface clocking API.*/ | ||
264 | int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id, | ||
265 | unsigned int freq, int dir); | ||
266 | |||
267 | int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai, | ||
268 | int div_id, int div); | ||
269 | |||
270 | int snd_soc_dai_set_pll(struct snd_soc_dai *dai, | ||
271 | int pll_id, unsigned int freq_in, unsigned int freq_out); | ||
272 | |||
273 | /* Digital Audio interface formatting */ | ||
274 | int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt); | ||
275 | |||
276 | int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai, | ||
277 | unsigned int mask, int slots); | ||
278 | |||
279 | int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate); | ||
280 | |||
281 | /* Digital Audio Interface mute */ | ||
282 | int snd_soc_dai_digital_mute(struct snd_soc_dai *dai, int mute); | ||
283 | |||
284 | /* | 193 | /* |
285 | *Controls | 194 | *Controls |
286 | */ | 195 | */ |
@@ -338,61 +247,6 @@ struct snd_soc_ops { | |||
338 | int (*trigger)(struct snd_pcm_substream *, int); | 247 | int (*trigger)(struct snd_pcm_substream *, int); |
339 | }; | 248 | }; |
340 | 249 | ||
341 | /* ASoC DAI ops */ | ||
342 | struct snd_soc_dai_ops { | ||
343 | /* DAI clocking configuration */ | ||
344 | int (*set_sysclk)(struct snd_soc_dai *dai, | ||
345 | int clk_id, unsigned int freq, int dir); | ||
346 | int (*set_pll)(struct snd_soc_dai *dai, | ||
347 | int pll_id, unsigned int freq_in, unsigned int freq_out); | ||
348 | int (*set_clkdiv)(struct snd_soc_dai *dai, int div_id, int div); | ||
349 | |||
350 | /* DAI format configuration */ | ||
351 | int (*set_fmt)(struct snd_soc_dai *dai, unsigned int fmt); | ||
352 | int (*set_tdm_slot)(struct snd_soc_dai *dai, | ||
353 | unsigned int mask, int slots); | ||
354 | int (*set_tristate)(struct snd_soc_dai *dai, int tristate); | ||
355 | |||
356 | /* digital mute */ | ||
357 | int (*digital_mute)(struct snd_soc_dai *dai, int mute); | ||
358 | }; | ||
359 | |||
360 | /* SoC DAI (Digital Audio Interface) */ | ||
361 | struct snd_soc_dai { | ||
362 | /* DAI description */ | ||
363 | char *name; | ||
364 | unsigned int id; | ||
365 | unsigned char type; | ||
366 | |||
367 | /* DAI callbacks */ | ||
368 | int (*probe)(struct platform_device *pdev, | ||
369 | struct snd_soc_dai *dai); | ||
370 | void (*remove)(struct platform_device *pdev, | ||
371 | struct snd_soc_dai *dai); | ||
372 | int (*suspend)(struct platform_device *pdev, | ||
373 | struct snd_soc_dai *dai); | ||
374 | int (*resume)(struct platform_device *pdev, | ||
375 | struct snd_soc_dai *dai); | ||
376 | |||
377 | /* ops */ | ||
378 | struct snd_soc_ops ops; | ||
379 | struct snd_soc_dai_ops dai_ops; | ||
380 | |||
381 | /* DAI capabilities */ | ||
382 | struct snd_soc_pcm_stream capture; | ||
383 | struct snd_soc_pcm_stream playback; | ||
384 | |||
385 | /* DAI runtime info */ | ||
386 | struct snd_pcm_runtime *runtime; | ||
387 | struct snd_soc_codec *codec; | ||
388 | unsigned int active; | ||
389 | unsigned char pop_wait:1; | ||
390 | void *dma_data; | ||
391 | |||
392 | /* DAI private data */ | ||
393 | void *private_data; | ||
394 | }; | ||
395 | |||
396 | /* SoC Audio Codec */ | 250 | /* SoC Audio Codec */ |
397 | struct snd_soc_codec { | 251 | struct snd_soc_codec { |
398 | char *name; | 252 | char *name; |
@@ -543,4 +397,6 @@ struct soc_enum { | |||
543 | void *dapm; | 397 | void *dapm; |
544 | }; | 398 | }; |
545 | 399 | ||
400 | #include <sound/soc-dai.h> | ||
401 | |||
546 | #endif | 402 | #endif |