sound/soc/codecs/tlv320aic3x.h

   1 /*
   2  * ALSA SoC TLV320AIC3X codec driver
   3  *
   4  * Author:      Vladimir Barinov, <vbarinov@embeddedalley.com>
   5  * Copyright:   (C) 2007 MontaVista Software, Inc., <source@mvista.com>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License version 2 as
   9  * published by the Free Software Foundation.
  10  */
  11
  12 #ifndef _AIC3X_H
  13 #define _AIC3X_H
  14
  15 /* AIC3X register space */
  16 #define AIC3X_CACHEREGNUM               103
  17
  18 /* Page select register */
  19 #define AIC3X_PAGE_SELECT               0
  20 /* Software reset register */
  21 #define AIC3X_RESET                     1
  22 /* Codec Sample rate select register */
  23 #define AIC3X_SAMPLE_RATE_SEL_REG       2
  24 /* PLL progrramming register A */
  25 #define AIC3X_PLL_PROGA_REG             3
  26 /* PLL progrramming register B */
  27 #define AIC3X_PLL_PROGB_REG             4
  28 /* PLL progrramming register C */
  29 #define AIC3X_PLL_PROGC_REG             5
  30 /* PLL progrramming register D */
  31 #define AIC3X_PLL_PROGD_REG             6
  32 /* Codec datapath setup register */
  33 #define AIC3X_CODEC_DATAPATH_REG        7
  34 /* Audio serial data interface control register A */
  35 #define AIC3X_ASD_INTF_CTRLA            8
  36 /* Audio serial data interface control register B */
  37 #define AIC3X_ASD_INTF_CTRLB            9
  38 /* Audio serial data interface control register C */
  39 #define AIC3X_ASD_INTF_CTRLC            10
  40 /* Audio overflow status and PLL R value programming register */
  41 #define AIC3X_OVRF_STATUS_AND_PLLR_REG  11
  42 /* Audio codec digital filter control register */
  43 #define AIC3X_CODEC_DFILT_CTRL          12
  44 /* Headset/button press detection register */
  45 #define AIC3X_HEADSET_DETECT_CTRL_A     13
  46 #define AIC3X_HEADSET_DETECT_CTRL_B     14
  47 /* ADC PGA Gain control registers */
  48 #define LADC_VOL                        15
  49 #define RADC_VOL                        16
  50 /* MIC3 control registers */
  51 #define MIC3LR_2_LADC_CTRL              17
  52 #define MIC3LR_2_RADC_CTRL              18
  53 /* Line1 Input control registers */
  54 #define LINE1L_2_LADC_CTRL              19
  55 #define LINE1R_2_LADC_CTRL              21
  56 #define LINE1R_2_RADC_CTRL              22
  57 #define LINE1L_2_RADC_CTRL              24
  58 /* Line2 Input control registers */
  59 #define LINE2L_2_LADC_CTRL              20
  60 #define LINE2R_2_RADC_CTRL              23
  61 /* MICBIAS Control Register */
  62 #define MICBIAS_CTRL                    25
  63
  64 /* AGC Control Registers A, B, C */
  65 #define LAGC_CTRL_A                     26
  66 #define LAGC_CTRL_B                     27
  67 #define LAGC_CTRL_C                     28
  68 #define RAGC_CTRL_A                     29
  69 #define RAGC_CTRL_B                     30
  70 #define RAGC_CTRL_C                     31
  71
  72 /* DAC Power and Left High Power Output control registers */
  73 #define DAC_PWR                         37
  74 #define HPLCOM_CFG                      37
  75 /* Right High Power Output control registers */
  76 #define HPRCOM_CFG                      38
  77 /* DAC Output Switching control registers */
  78 #define DAC_LINE_MUX                    41
  79 /* High Power Output Driver Pop Reduction registers */
  80 #define HPOUT_POP_REDUCTION             42
  81 /* DAC Digital control registers */
  82 #define LDAC_VOL                        43
  83 #define RDAC_VOL                        44
  84 /* High Power Output control registers */
  85 #define LINE2L_2_HPLOUT_VOL             45
  86 #define LINE2R_2_HPROUT_VOL             62
  87 #define PGAL_2_HPLOUT_VOL               46
  88 #define PGAL_2_HPROUT_VOL               60
  89 #define PGAR_2_HPLOUT_VOL               49
  90 #define PGAR_2_HPROUT_VOL               63
  91 #define DACL1_2_HPLOUT_VOL              47
  92 #define DACR1_2_HPROUT_VOL              64
  93 #define HPLOUT_CTRL                     51
  94 #define HPROUT_CTRL                     65
  95 /* High Power COM control registers */
  96 #define LINE2L_2_HPLCOM_VOL             52
  97 #define LINE2R_2_HPRCOM_VOL             69
  98 #define PGAL_2_HPLCOM_VOL               53
  99 #define PGAR_2_HPLCOM_VOL               56
 100 #define PGAL_2_HPRCOM_VOL               67
 101 #define PGAR_2_HPRCOM_VOL               70
 102 #define DACL1_2_HPLCOM_VOL              54
 103 #define DACR1_2_HPRCOM_VOL              71
 104 #define HPLCOM_CTRL                     58
 105 #define HPRCOM_CTRL                     72
 106 /* Mono Line Output Plus/Minus control registers */
 107 #define LINE2L_2_MONOLOPM_VOL           73
 108 #define LINE2R_2_MONOLOPM_VOL           76
 109 #define PGAL_2_MONOLOPM_VOL             74
 110 #define PGAR_2_MONOLOPM_VOL             77
 111 #define DACL1_2_MONOLOPM_VOL            75
 112 #define DACR1_2_MONOLOPM_VOL            78
 113 #define MONOLOPM_CTRL                   79
 114 /* Line Output Plus/Minus control registers */
 115 #define LINE2L_2_LLOPM_VOL              80
 116 #define LINE2L_2_RLOPM_VOL              87
 117 #define LINE2R_2_LLOPM_VOL              83
 118 #define LINE2R_2_RLOPM_VOL              90
 119 #define PGAL_2_LLOPM_VOL                81
 120 #define PGAL_2_RLOPM_VOL                88
 121 #define PGAR_2_LLOPM_VOL                84
 122 #define PGAR_2_RLOPM_VOL                91
 123 #define DACL1_2_LLOPM_VOL               82
 124 #define DACL1_2_RLOPM_VOL               89
 125 #define DACR1_2_RLOPM_VOL               92
 126 #define DACR1_2_LLOPM_VOL               85
 127 #define LLOPM_CTRL                      86
 128 #define RLOPM_CTRL                      93
 129 /* GPIO/IRQ registers */
 130 #define AIC3X_STICKY_IRQ_FLAGS_REG      96
 131 #define AIC3X_RT_IRQ_FLAGS_REG          97
 132 #define AIC3X_GPIO1_REG                 98
 133 #define AIC3X_GPIO2_REG                 99
 134 #define AIC3X_GPIOA_REG                 100
 135 #define AIC3X_GPIOB_REG                 101
 136 /* Clock generation control register */
 137 #define AIC3X_CLKGEN_CTRL_REG           102
 138
 139 /* Page select register bits */
 140 #define PAGE0_SELECT            0
 141 #define PAGE1_SELECT            1
 142
 143 /* Audio serial data interface control register A bits */
 144 #define BIT_CLK_MASTER          0x80
 145 #define WORD_CLK_MASTER         0x40
 146
 147 /* Codec Datapath setup register 7 */
 148 #define FSREF_44100             (1 << 7)
 149 #define FSREF_48000             (0 << 7)
 150 #define DUAL_RATE_MODE          ((1 << 5) | (1 << 6))
 151 #define LDAC2LCH                (0x1 << 3)
 152 #define RDAC2RCH                (0x1 << 1)
 153
 154 /* PLL registers bitfields */
 155 #define PLLP_SHIFT              0
 156 #define PLLQ_SHIFT              3
 157 #define PLLR_SHIFT              0
 158 #define PLLJ_SHIFT              2
 159 #define PLLD_MSB_SHIFT          0
 160 #define PLLD_LSB_SHIFT          2
 161
 162 /* Clock generation register bits */
 163 #define CODEC_CLKIN_PLLDIV      0
 164 #define CODEC_CLKIN_CLKDIV      1
 165 #define PLL_CLKIN_SHIFT         4
 166 #define MCLK_SOURCE             0x0
 167 #define PLL_CLKDIV_SHIFT        0
 168
 169 /* Software reset register bits */
 170 #define SOFT_RESET              0x80
 171
 172 /* PLL progrramming register A bits */
 173 #define PLL_ENABLE              0x80
 174
 175 /* Route bits */
 176 #define ROUTE_ON                0x80
 177
 178 /* Mute bits */
 179 #define UNMUTE                  0x08
 180 #define MUTE_ON                 0x80
 181
 182 /* Power bits */
 183 #define LADC_PWR_ON             0x04
 184 #define RADC_PWR_ON             0x04
 185 #define LDAC_PWR_ON             0x80
 186 #define RDAC_PWR_ON             0x40
 187 #define HPLOUT_PWR_ON           0x01
 188 #define HPROUT_PWR_ON           0x01
 189 #define HPLCOM_PWR_ON           0x01
 190 #define HPRCOM_PWR_ON           0x01
 191 #define MONOLOPM_PWR_ON         0x01
 192 #define LLOPM_PWR_ON            0x01
 193 #define RLOPM_PWR_ON    0x01
 194
 195 #define INVERT_VOL(val)   (0x7f - val)
 196
 197 /* Default output volume (inverted) */
 198 #define DEFAULT_VOL     INVERT_VOL(0x50)
 199 /* Default input volume */
 200 #define DEFAULT_GAIN    0x20
 201
 202 /* GPIO API */
 203 enum {
 204         AIC3X_GPIO1_FUNC_DISABLED               = 0,
 205         AIC3X_GPIO1_FUNC_AUDIO_WORDCLK_ADC      = 1,
 206         AIC3X_GPIO1_FUNC_CLOCK_MUX              = 2,
 207         AIC3X_GPIO1_FUNC_CLOCK_MUX_DIV2         = 3,
 208         AIC3X_GPIO1_FUNC_CLOCK_MUX_DIV4         = 4,
 209         AIC3X_GPIO1_FUNC_CLOCK_MUX_DIV8         = 5,
 210         AIC3X_GPIO1_FUNC_SHORT_CIRCUIT_IRQ      = 6,
 211         AIC3X_GPIO1_FUNC_AGC_NOISE_IRQ          = 7,
 212         AIC3X_GPIO1_FUNC_INPUT                  = 8,
 213         AIC3X_GPIO1_FUNC_OUTPUT                 = 9,
 214         AIC3X_GPIO1_FUNC_DIGITAL_MIC_MODCLK     = 10,
 215         AIC3X_GPIO1_FUNC_AUDIO_WORDCLK          = 11,
 216         AIC3X_GPIO1_FUNC_BUTTON_IRQ             = 12,
 217         AIC3X_GPIO1_FUNC_HEADSET_DETECT_IRQ     = 13,
 218         AIC3X_GPIO1_FUNC_HEADSET_DETECT_OR_BUTTON_IRQ   = 14,
 219         AIC3X_GPIO1_FUNC_ALL_IRQ                = 16
 220 };
 221
 222 enum {
 223         AIC3X_GPIO2_FUNC_DISABLED               = 0,
 224         AIC3X_GPIO2_FUNC_HEADSET_DETECT_IRQ     = 2,
 225         AIC3X_GPIO2_FUNC_INPUT                  = 3,
 226         AIC3X_GPIO2_FUNC_OUTPUT                 = 4,
 227         AIC3X_GPIO2_FUNC_DIGITAL_MIC_INPUT      = 5,
 228         AIC3X_GPIO2_FUNC_AUDIO_BITCLK           = 8,
 229         AIC3X_GPIO2_FUNC_HEADSET_DETECT_OR_BUTTON_IRQ = 9,
 230         AIC3X_GPIO2_FUNC_ALL_IRQ                = 10,
 231         AIC3X_GPIO2_FUNC_SHORT_CIRCUIT_OR_AGC_IRQ = 11,
 232         AIC3X_GPIO2_FUNC_HEADSET_OR_BUTTON_PRESS_OR_SHORT_CIRCUIT_IRQ = 12,
 233         AIC3X_GPIO2_FUNC_SHORT_CIRCUIT_IRQ      = 13,
 234         AIC3X_GPIO2_FUNC_AGC_NOISE_IRQ          = 14,
 235         AIC3X_GPIO2_FUNC_BUTTON_PRESS_IRQ       = 15
 236 };
 237
 238 void aic3x_set_gpio(struct snd_soc_codec *codec, int gpio, int state);
 239 int aic3x_get_gpio(struct snd_soc_codec *codec, int gpio);
 240
 241 /* headset detection / button API */
 242
 243 /* The AIC3x supports detection of stereo headsets (GND + left + right signal)
 244  * and cellular headsets (GND + speaker output + microphone input).
 245  * It is recommended to enable MIC bias for this function to work properly.
 246  * For more information, please refer to the datasheet. */
 247 enum {
 248         AIC3X_HEADSET_DETECT_OFF        = 0,
 249         AIC3X_HEADSET_DETECT_STEREO     = 1,
 250         AIC3X_HEADSET_DETECT_CELLULAR   = 2,
 251         AIC3X_HEADSET_DETECT_BOTH       = 3
 252 };
 253
 254 enum {
 255         AIC3X_HEADSET_DEBOUNCE_16MS     = 0,
 256         AIC3X_HEADSET_DEBOUNCE_32MS     = 1,
 257         AIC3X_HEADSET_DEBOUNCE_64MS     = 2,
 258         AIC3X_HEADSET_DEBOUNCE_128MS    = 3,
 259         AIC3X_HEADSET_DEBOUNCE_256MS    = 4,
 260         AIC3X_HEADSET_DEBOUNCE_512MS    = 5
 261 };
 262
 263 enum {
 264         AIC3X_BUTTON_DEBOUNCE_0MS       = 0,
 265         AIC3X_BUTTON_DEBOUNCE_8MS       = 1,
 266         AIC3X_BUTTON_DEBOUNCE_16MS      = 2,
 267         AIC3X_BUTTON_DEBOUNCE_32MS      = 3
 268 };
 269
 270 #define AIC3X_HEADSET_DETECT_ENABLED    0x80
 271 #define AIC3X_HEADSET_DETECT_SHIFT      5
 272 #define AIC3X_HEADSET_DETECT_MASK       3
 273 #define AIC3X_HEADSET_DEBOUNCE_SHIFT    2
 274 #define AIC3X_HEADSET_DEBOUNCE_MASK     7
 275 #define AIC3X_BUTTON_DEBOUNCE_SHIFT     0
 276 #define AIC3X_BUTTON_DEBOUNCE_MASK      3
 277
 278 /* see the enums above for valid parameters to this function */
 279 void aic3x_set_headset_detection(struct snd_soc_codec *codec, int detect,
 280                                  int headset_debounce, int button_debounce);
 281 int aic3x_headset_detected(struct snd_soc_codec *codec);
 282 int aic3x_button_pressed(struct snd_soc_codec *codec);
 283
 284 struct aic3x_setup_data {
 285         int i2c_bus;
 286         unsigned short i2c_address;
 287         unsigned int gpio_func[2];
 288 };
 289
 290 extern struct snd_soc_dai aic3x_dai;
 291 extern struct snd_soc_codec_device soc_codec_dev_aic3x;
 292
 293 #endif /* _AIC3X_H */