1 /* 2 * linux/sound/soc.h -- ALSA SoC Layer 3 * 4 * Author: Liam Girdwood 5 * Created: Aug 11th 2005 6 * Copyright: Wolfson Microelectronics. PLC. 7 * 8 * This program is free software; you can redistribute it and/or modify 9 * it under the terms of the GNU General Public License version 2 as 10 * published by the Free Software Foundation. 11 */ 12 13 #ifndef __LINUX_SND_SOC_H 14 #define __LINUX_SND_SOC_H 15 16 #include <linux/platform_device.h> 17 #include <linux/types.h> 18 #include <linux/workqueue.h> 19 #include <sound/core.h> 20 #include <sound/pcm.h> 21 #include <sound/control.h> 22 #include <sound/ac97_codec.h> 23 24 #define SND_SOC_VERSION "0.13.2" 25 26 /* 27 * Convenience kcontrol builders 28 */ 29 #define SOC_SINGLE_VALUE(reg, shift, max, invert) ((reg) | ((shift) << 8) |\ 30 ((shift) << 12) | ((max) << 16) | ((invert) << 24)) 31 #define SOC_SINGLE_VALUE_EXT(reg, max, invert) ((reg) | ((max) << 16) |\ 32 ((invert) << 31)) 33 #define SOC_SINGLE(xname, reg, shift, max, invert) \ 34 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \ 35 .info = snd_soc_info_volsw, .get = snd_soc_get_volsw,\ 36 .put = snd_soc_put_volsw, \ 37 .private_value = SOC_SINGLE_VALUE(reg, shift, max, invert) } 38 #define SOC_SINGLE_TLV(xname, reg, shift, max, invert, tlv_array) \ 39 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \ 40 .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\ 41 SNDRV_CTL_ELEM_ACCESS_READWRITE,\ 42 .tlv.p = (tlv_array), \ 43 .info = snd_soc_info_volsw, .get = snd_soc_get_volsw,\ 44 .put = snd_soc_put_volsw, \ 45 .private_value = SOC_SINGLE_VALUE(reg, shift, max, invert) } 46 #define SOC_DOUBLE(xname, reg, shift_left, shift_right, max, invert) \ 47 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\ 48 .info = snd_soc_info_volsw, .get = snd_soc_get_volsw, \ 49 .put = snd_soc_put_volsw, \ 50 .private_value = (reg) | ((shift_left) << 8) | \ 51 ((shift_right) << 12) | ((max) << 16) | ((invert) << 24) } 52 #define SOC_DOUBLE_R(xname, reg_left, reg_right, shift, max, invert) \ 53 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), \ 54 .info = snd_soc_info_volsw_2r, \ 55 .get = snd_soc_get_volsw_2r, .put = snd_soc_put_volsw_2r, \ 56 .private_value = (reg_left) | ((shift) << 8) | \ 57 ((max) << 12) | ((invert) << 20) | ((reg_right) << 24) } 58 #define SOC_DOUBLE_TLV(xname, reg, shift_left, shift_right, max, invert, tlv_array) \ 59 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\ 60 .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\ 61 SNDRV_CTL_ELEM_ACCESS_READWRITE,\ 62 .tlv.p = (tlv_array), \ 63 .info = snd_soc_info_volsw, .get = snd_soc_get_volsw, \ 64 .put = snd_soc_put_volsw, \ 65 .private_value = (reg) | ((shift_left) << 8) | \ 66 ((shift_right) << 12) | ((max) << 16) | ((invert) << 24) } 67 #define SOC_DOUBLE_R_TLV(xname, reg_left, reg_right, shift, max, invert, tlv_array) \ 68 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname),\ 69 .access = SNDRV_CTL_ELEM_ACCESS_TLV_READ |\ 70 SNDRV_CTL_ELEM_ACCESS_READWRITE,\ 71 .tlv.p = (tlv_array), \ 72 .info = snd_soc_info_volsw_2r, \ 73 .get = snd_soc_get_volsw_2r, .put = snd_soc_put_volsw_2r, \ 74 .private_value = (reg_left) | ((shift) << 8) | \ 75 ((max) << 12) | ((invert) << 20) | ((reg_right) << 24) } 76 #define SOC_ENUM_DOUBLE(xreg, xshift_l, xshift_r, xmask, xtexts) \ 77 { .reg = xreg, .shift_l = xshift_l, .shift_r = xshift_r, \ 78 .mask = xmask, .texts = xtexts } 79 #define SOC_ENUM_SINGLE(xreg, xshift, xmask, xtexts) \ 80 SOC_ENUM_DOUBLE(xreg, xshift, xshift, xmask, xtexts) 81 #define SOC_ENUM_SINGLE_EXT(xmask, xtexts) \ 82 { .mask = xmask, .texts = xtexts } 83 #define SOC_ENUM(xname, xenum) \ 84 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname,\ 85 .info = snd_soc_info_enum_double, \ 86 .get = snd_soc_get_enum_double, .put = snd_soc_put_enum_double, \ 87 .private_value = (unsigned long)&xenum } 88 #define SOC_SINGLE_EXT(xname, xreg, xshift, xmask, xinvert,\ 89 xhandler_get, xhandler_put) \ 90 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \ 91 .info = snd_soc_info_volsw, \ 92 .get = xhandler_get, .put = xhandler_put, \ 93 .private_value = SOC_SINGLE_VALUE(xreg, xshift, xmask, xinvert) } 94 #define SOC_SINGLE_BOOL_EXT(xname, xdata, xhandler_get, xhandler_put) \ 95 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \ 96 .info = snd_soc_info_bool_ext, \ 97 .get = xhandler_get, .put = xhandler_put, \ 98 .private_value = xdata } 99 #define SOC_ENUM_EXT(xname, xenum, xhandler_get, xhandler_put) \ 100 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, \ 101 .info = snd_soc_info_enum_ext, \ 102 .get = xhandler_get, .put = xhandler_put, \ 103 .private_value = (unsigned long)&xenum } 104 105 /* 106 * Digital Audio Interface (DAI) types 107 */ 108 #define SND_SOC_DAI_AC97 0x1 109 #define SND_SOC_DAI_I2S 0x2 110 #define SND_SOC_DAI_PCM 0x4 111 #define SND_SOC_DAI_AC97_BUS 0x8 /* for custom i.e. non ac97_codec.c */ 112 113 /* 114 * DAI hardware audio formats 115 */ 116 #define SND_SOC_DAIFMT_I2S 0 /* I2S mode */ 117 #define SND_SOC_DAIFMT_RIGHT_J 1 /* Right justified mode */ 118 #define SND_SOC_DAIFMT_LEFT_J 2 /* Left Justified mode */ 119 #define SND_SOC_DAIFMT_DSP_A 3 /* L data msb after FRM or LRC */ 120 #define SND_SOC_DAIFMT_DSP_B 4 /* L data msb during FRM or LRC */ 121 #define SND_SOC_DAIFMT_AC97 5 /* AC97 */ 122 123 #define SND_SOC_DAIFMT_MSB SND_SOC_DAIFMT_LEFT_J 124 #define SND_SOC_DAIFMT_LSB SND_SOC_DAIFMT_RIGHT_J 125 126 /* 127 * DAI Gating 128 */ 129 #define SND_SOC_DAIFMT_CONT (0 << 4) /* continuous clock */ 130 #define SND_SOC_DAIFMT_GATED (1 << 4) /* clock is gated when not Tx/Rx */ 131 132 /* 133 * DAI Sync 134 * Synchronous LR (Left Right) clocks and Frame signals. 135 */ 136 #define SND_SOC_DAIFMT_SYNC (0 << 5) /* Tx FRM = Rx FRM */ 137 #define SND_SOC_DAIFMT_ASYNC (1 << 5) /* Tx FRM ~ Rx FRM */ 138 139 /* 140 * TDM 141 */ 142 #define SND_SOC_DAIFMT_TDM (1 << 6) 143 144 /* 145 * DAI hardware signal inversions 146 */ 147 #define SND_SOC_DAIFMT_NB_NF (0 << 8) /* normal bclk + frm */ 148 #define SND_SOC_DAIFMT_NB_IF (1 << 8) /* normal bclk + inv frm */ 149 #define SND_SOC_DAIFMT_IB_NF (2 << 8) /* invert bclk + nor frm */ 150 #define SND_SOC_DAIFMT_IB_IF (3 << 8) /* invert bclk + frm */ 151 152 /* 153 * DAI hardware clock masters 154 * This is wrt the codec, the inverse is true for the interface 155 * i.e. if the codec is clk and frm master then the interface is 156 * clk and frame slave. 157 */ 158 #define SND_SOC_DAIFMT_CBM_CFM (0 << 12) /* codec clk & frm master */ 159 #define SND_SOC_DAIFMT_CBS_CFM (1 << 12) /* codec clk slave & frm master */ 160 #define SND_SOC_DAIFMT_CBM_CFS (2 << 12) /* codec clk master & frame slave */ 161 #define SND_SOC_DAIFMT_CBS_CFS (3 << 12) /* codec clk & frm slave */ 162 163 #define SND_SOC_DAIFMT_FORMAT_MASK 0x000f 164 #define SND_SOC_DAIFMT_CLOCK_MASK 0x00f0 165 #define SND_SOC_DAIFMT_INV_MASK 0x0f00 166 #define SND_SOC_DAIFMT_MASTER_MASK 0xf000 167 168 169 /* 170 * Master Clock Directions 171 */ 172 #define SND_SOC_CLOCK_IN 0 173 #define SND_SOC_CLOCK_OUT 1 174 175 /* 176 * AC97 codec ID's bitmask 177 */ 178 #define SND_SOC_DAI_AC97_ID0 (1 << 0) 179 #define SND_SOC_DAI_AC97_ID1 (1 << 1) 180 #define SND_SOC_DAI_AC97_ID2 (1 << 2) 181 #define SND_SOC_DAI_AC97_ID3 (1 << 3) 182 183 struct snd_soc_device; 184 struct snd_soc_pcm_stream; 185 struct snd_soc_ops; 186 struct snd_soc_dai_mode; 187 struct snd_soc_pcm_runtime; 188 struct snd_soc_codec_dai; 189 struct snd_soc_cpu_dai; 190 struct snd_soc_codec; 191 struct snd_soc_machine_config; 192 struct soc_enum; 193 struct snd_soc_ac97_ops; 194 struct snd_soc_clock_info; 195 196 typedef int (*hw_write_t)(void *,const char* ,int); 197 typedef int (*hw_read_t)(void *,char* ,int); 198 199 extern struct snd_ac97_bus_ops soc_ac97_ops; 200 201 /* pcm <-> DAI connect */ 202 void snd_soc_free_pcms(struct snd_soc_device *socdev); 203 int snd_soc_new_pcms(struct snd_soc_device *socdev, int idx, const char *xid); 204 int snd_soc_register_card(struct snd_soc_device *socdev); 205 206 /* set runtime hw params */ 207 int snd_soc_set_runtime_hwparams(struct snd_pcm_substream *substream, 208 const struct snd_pcm_hardware *hw); 209 210 /* codec IO */ 211 #define snd_soc_read(codec, reg) codec->read(codec, reg) 212 #define snd_soc_write(codec, reg, value) codec->write(codec, reg, value) 213 214 /* codec register bit access */ 215 int snd_soc_update_bits(struct snd_soc_codec *codec, unsigned short reg, 216 unsigned short mask, unsigned short value); 217 int snd_soc_test_bits(struct snd_soc_codec *codec, unsigned short reg, 218 unsigned short mask, unsigned short value); 219 220 int snd_soc_new_ac97_codec(struct snd_soc_codec *codec, 221 struct snd_ac97_bus_ops *ops, int num); 222 void snd_soc_free_ac97_codec(struct snd_soc_codec *codec); 223 224 /* 225 *Controls 226 */ 227 struct snd_kcontrol *snd_soc_cnew(const struct snd_kcontrol_new *_template, 228 void *data, char *long_name); 229 int snd_soc_info_enum_double(struct snd_kcontrol *kcontrol, 230 struct snd_ctl_elem_info *uinfo); 231 int snd_soc_info_enum_ext(struct snd_kcontrol *kcontrol, 232 struct snd_ctl_elem_info *uinfo); 233 int snd_soc_get_enum_double(struct snd_kcontrol *kcontrol, 234 struct snd_ctl_elem_value *ucontrol); 235 int snd_soc_put_enum_double(struct snd_kcontrol *kcontrol, 236 struct snd_ctl_elem_value *ucontrol); 237 int snd_soc_info_volsw(struct snd_kcontrol *kcontrol, 238 struct snd_ctl_elem_info *uinfo); 239 int snd_soc_info_volsw_ext(struct snd_kcontrol *kcontrol, 240 struct snd_ctl_elem_info *uinfo); 241 #define snd_soc_info_bool_ext snd_ctl_boolean_mono_info 242 int snd_soc_get_volsw(struct snd_kcontrol *kcontrol, 243 struct snd_ctl_elem_value *ucontrol); 244 int snd_soc_put_volsw(struct snd_kcontrol *kcontrol, 245 struct snd_ctl_elem_value *ucontrol); 246 int snd_soc_info_volsw_2r(struct snd_kcontrol *kcontrol, 247 struct snd_ctl_elem_info *uinfo); 248 int snd_soc_get_volsw_2r(struct snd_kcontrol *kcontrol, 249 struct snd_ctl_elem_value *ucontrol); 250 int snd_soc_put_volsw_2r(struct snd_kcontrol *kcontrol, 251 struct snd_ctl_elem_value *ucontrol); 252 253 /* SoC PCM stream information */ 254 struct snd_soc_pcm_stream { 255 char *stream_name; 256 u64 formats; /* SNDRV_PCM_FMTBIT_* */ 257 unsigned int rates; /* SNDRV_PCM_RATE_* */ 258 unsigned int rate_min; /* min rate */ 259 unsigned int rate_max; /* max rate */ 260 unsigned int channels_min; /* min channels */ 261 unsigned int channels_max; /* max channels */ 262 unsigned int active:1; /* stream is in use */ 263 }; 264 265 /* SoC audio ops */ 266 struct snd_soc_ops { 267 int (*startup)(struct snd_pcm_substream *); 268 void (*shutdown)(struct snd_pcm_substream *); 269 int (*hw_params)(struct snd_pcm_substream *, struct snd_pcm_hw_params *); 270 int (*hw_free)(struct snd_pcm_substream *); 271 int (*prepare)(struct snd_pcm_substream *); 272 int (*trigger)(struct snd_pcm_substream *, int); 273 }; 274 275 /* ASoC DAI ops */ 276 struct snd_soc_dai_ops { 277 /* DAI clocking configuration */ 278 int (*set_sysclk)(struct snd_soc_codec_dai *codec_dai, 279 int clk_id, unsigned int freq, int dir); 280 int (*set_pll)(struct snd_soc_codec_dai *codec_dai, 281 int pll_id, unsigned int freq_in, unsigned int freq_out); 282 int (*set_clkdiv)(struct snd_soc_codec_dai *codec_dai, 283 int div_id, int div); 284 285 /* DAI format configuration */ 286 int (*set_fmt)(struct snd_soc_codec_dai *codec_dai, 287 unsigned int fmt); 288 int (*set_tdm_slot)(struct snd_soc_codec_dai *codec_dai, 289 unsigned int mask, int slots); 290 int (*set_tristate)(struct snd_soc_codec_dai *, int tristate); 291 292 /* digital mute */ 293 int (*digital_mute)(struct snd_soc_codec_dai *, int mute); 294 }; 295 296 /* SoC Codec DAI */ 297 struct snd_soc_codec_dai { 298 char *name; 299 int id; 300 unsigned char type; 301 302 /* DAI capabilities */ 303 struct snd_soc_pcm_stream playback; 304 struct snd_soc_pcm_stream capture; 305 306 /* DAI runtime info */ 307 struct snd_soc_codec *codec; 308 unsigned int active; 309 unsigned char pop_wait:1; 310 311 /* ops */ 312 struct snd_soc_ops ops; 313 struct snd_soc_dai_ops dai_ops; 314 315 /* DAI private data */ 316 void *private_data; 317 }; 318 319 /* SoC CPU DAI */ 320 struct snd_soc_cpu_dai { 321 322 /* DAI description */ 323 char *name; 324 unsigned int id; 325 unsigned char type; 326 327 /* DAI callbacks */ 328 int (*probe)(struct platform_device *pdev); 329 void (*remove)(struct platform_device *pdev); 330 int (*suspend)(struct platform_device *pdev, 331 struct snd_soc_cpu_dai *cpu_dai); 332 int (*resume)(struct platform_device *pdev, 333 struct snd_soc_cpu_dai *cpu_dai); 334 335 /* ops */ 336 struct snd_soc_ops ops; 337 struct snd_soc_dai_ops dai_ops; 338 339 /* DAI capabilities */ 340 struct snd_soc_pcm_stream capture; 341 struct snd_soc_pcm_stream playback; 342 343 /* DAI runtime info */ 344 struct snd_pcm_runtime *runtime; 345 unsigned char active:1; 346 void *dma_data; 347 348 /* DAI private data */ 349 void *private_data; 350 }; 351 352 /* SoC Audio Codec */ 353 struct snd_soc_codec { 354 char *name; 355 struct module *owner; 356 struct mutex mutex; 357 358 /* callbacks */ 359 int (*dapm_event)(struct snd_soc_codec *codec, int event); 360 361 /* runtime */ 362 struct snd_card *card; 363 struct snd_ac97 *ac97; /* for ad-hoc ac97 devices */ 364 unsigned int active; 365 unsigned int pcm_devs; 366 void *private_data; 367 368 /* codec IO */ 369 void *control_data; /* codec control (i2c/3wire) data */ 370 unsigned int (*read)(struct snd_soc_codec *, unsigned int); 371 int (*write)(struct snd_soc_codec *, unsigned int, unsigned int); 372 hw_write_t hw_write; 373 hw_read_t hw_read; 374 void *reg_cache; 375 short reg_cache_size; 376 short reg_cache_step; 377 378 /* dapm */ 379 struct list_head dapm_widgets; 380 struct list_head dapm_paths; 381 unsigned int dapm_state; 382 unsigned int suspend_dapm_state; 383 struct delayed_work delayed_work; 384 385 /* codec DAI's */ 386 struct snd_soc_codec_dai *dai; 387 unsigned int num_dai; 388 }; 389 390 /* codec device */ 391 struct snd_soc_codec_device { 392 int (*probe)(struct platform_device *pdev); 393 int (*remove)(struct platform_device *pdev); 394 int (*suspend)(struct platform_device *pdev, pm_message_t state); 395 int (*resume)(struct platform_device *pdev); 396 }; 397 398 /* SoC platform interface */ 399 struct snd_soc_platform { 400 char *name; 401 402 int (*probe)(struct platform_device *pdev); 403 int (*remove)(struct platform_device *pdev); 404 int (*suspend)(struct platform_device *pdev, 405 struct snd_soc_cpu_dai *cpu_dai); 406 int (*resume)(struct platform_device *pdev, 407 struct snd_soc_cpu_dai *cpu_dai); 408 409 /* pcm creation and destruction */ 410 int (*pcm_new)(struct snd_card *, struct snd_soc_codec_dai *, 411 struct snd_pcm *); 412 void (*pcm_free)(struct snd_pcm *); 413 414 /* platform stream ops */ 415 struct snd_pcm_ops *pcm_ops; 416 }; 417 418 /* SoC machine DAI configuration, glues a codec and cpu DAI together */ 419 struct snd_soc_dai_link { 420 char *name; /* Codec name */ 421 char *stream_name; /* Stream name */ 422 423 /* DAI */ 424 struct snd_soc_codec_dai *codec_dai; 425 struct snd_soc_cpu_dai *cpu_dai; 426 427 /* machine stream operations */ 428 struct snd_soc_ops *ops; 429 430 /* codec/machine specific init - e.g. add machine controls */ 431 int (*init)(struct snd_soc_codec *codec); 432 433 /* DAI pcm */ 434 struct snd_pcm *pcm; 435 }; 436 437 /* SoC machine */ 438 struct snd_soc_machine { 439 char *name; 440 441 int (*probe)(struct platform_device *pdev); 442 int (*remove)(struct platform_device *pdev); 443 444 /* the pre and post PM functions are used to do any PM work before and 445 * after the codec and DAI's do any PM work. */ 446 int (*suspend_pre)(struct platform_device *pdev, pm_message_t state); 447 int (*suspend_post)(struct platform_device *pdev, pm_message_t state); 448 int (*resume_pre)(struct platform_device *pdev); 449 int (*resume_post)(struct platform_device *pdev); 450 451 /* callbacks */ 452 int (*dapm_event)(struct snd_soc_machine *, int event); 453 454 /* CPU <--> Codec DAI links */ 455 struct snd_soc_dai_link *dai_link; 456 int num_links; 457 }; 458 459 /* SoC Device - the audio subsystem */ 460 struct snd_soc_device { 461 struct device *dev; 462 struct snd_soc_machine *machine; 463 struct snd_soc_platform *platform; 464 struct snd_soc_codec *codec; 465 struct snd_soc_codec_device *codec_dev; 466 struct delayed_work delayed_work; 467 void *codec_data; 468 }; 469 470 /* runtime channel data */ 471 struct snd_soc_pcm_runtime { 472 struct snd_soc_dai_link *dai; 473 struct snd_soc_device *socdev; 474 }; 475 476 /* enumerated kcontrol */ 477 struct soc_enum { 478 unsigned short reg; 479 unsigned short reg2; 480 unsigned char shift_l; 481 unsigned char shift_r; 482 unsigned int mask; 483 const char **texts; 484 void *dapm; 485 }; 486 487 #endif 488