aboutsummaryrefslogtreecommitdiffstats
path: root/include/sound/soc.h
diff options
context:
space:
mode:
authorMark Brown <broonie@opensource.wolfsonmicro.com>2008-07-23 09:03:07 -0400
committerMark Brown <broonie@opensource.wolfsonmicro.com>2008-11-21 09:02:08 -0500
commita47cbe7263236691ee0bbc392f7fd4ec0da1159f (patch)
tree78b009a80c5c4bd625a3935ec621d5b5b2d42b74 /include/sound/soc.h
parent5de27b6cc0a8a1d27158ec9047cb5981745edfc0 (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.h148
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
224struct snd_soc_device; 154struct snd_soc_device;
225struct snd_soc_pcm_stream; 155struct snd_soc_pcm_stream;
226struct snd_soc_ops; 156struct 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);
261void snd_soc_free_ac97_codec(struct snd_soc_codec *codec); 191void snd_soc_free_ac97_codec(struct snd_soc_codec *codec);
262 192
263/* Digital Audio Interface clocking API.*/
264int snd_soc_dai_set_sysclk(struct snd_soc_dai *dai, int clk_id,
265 unsigned int freq, int dir);
266
267int snd_soc_dai_set_clkdiv(struct snd_soc_dai *dai,
268 int div_id, int div);
269
270int 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 */
274int snd_soc_dai_set_fmt(struct snd_soc_dai *dai, unsigned int fmt);
275
276int snd_soc_dai_set_tdm_slot(struct snd_soc_dai *dai,
277 unsigned int mask, int slots);
278
279int snd_soc_dai_set_tristate(struct snd_soc_dai *dai, int tristate);
280
281/* Digital Audio Interface mute */
282int 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 */
342struct 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) */
361struct 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 */
397struct snd_soc_codec { 251struct 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