1 #ifndef _AC97_CODEC_H_ 2 #define _AC97_CODEC_H_ 3 4 #include <linux/types.h> 5 #include <linux/soundcard.h> 6 7 /* AC97 1.0 */ 8 #define AC97_RESET 0x0000 // 9 #define AC97_MASTER_VOL_STEREO 0x0002 // Line Out 10 #define AC97_HEADPHONE_VOL 0x0004 // 11 #define AC97_MASTER_VOL_MONO 0x0006 // TAD Output 12 #define AC97_MASTER_TONE 0x0008 // 13 #define AC97_PCBEEP_VOL 0x000a // none 14 #define AC97_PHONE_VOL 0x000c // TAD Input (mono) 15 #define AC97_MIC_VOL 0x000e // MIC Input (mono) 16 #define AC97_LINEIN_VOL 0x0010 // Line Input (stereo) 17 #define AC97_CD_VOL 0x0012 // CD Input (stereo) 18 #define AC97_VIDEO_VOL 0x0014 // none 19 #define AC97_AUX_VOL 0x0016 // Aux Input (stereo) 20 #define AC97_PCMOUT_VOL 0x0018 // Wave Output (stereo) 21 #define AC97_RECORD_SELECT 0x001a // 22 #define AC97_RECORD_GAIN 0x001c 23 #define AC97_RECORD_GAIN_MIC 0x001e 24 #define AC97_GENERAL_PURPOSE 0x0020 25 #define AC97_3D_CONTROL 0x0022 26 #define AC97_MODEM_RATE 0x0024 27 #define AC97_POWER_CONTROL 0x0026 28 29 /* AC'97 2.0 */ 30 #define AC97_EXTENDED_ID 0x0028 /* Extended Audio ID */ 31 #define AC97_EXTENDED_STATUS 0x002A /* Extended Audio Status */ 32 #define AC97_PCM_FRONT_DAC_RATE 0x002C /* PCM Front DAC Rate */ 33 #define AC97_PCM_SURR_DAC_RATE 0x002E /* PCM Surround DAC Rate */ 34 #define AC97_PCM_LFE_DAC_RATE 0x0030 /* PCM LFE DAC Rate */ 35 #define AC97_PCM_LR_ADC_RATE 0x0032 /* PCM LR ADC Rate */ 36 #define AC97_PCM_MIC_ADC_RATE 0x0034 /* PCM MIC ADC Rate */ 37 #define AC97_CENTER_LFE_MASTER 0x0036 /* Center + LFE Master Volume */ 38 #define AC97_SURROUND_MASTER 0x0038 /* Surround (Rear) Master Volume */ 39 #define AC97_RESERVED_3A 0x003A /* Reserved in AC '97 < 2.2 */ 40 41 /* AC'97 2.2 */ 42 #define AC97_SPDIF_CONTROL 0x003A /* S/PDIF Control */ 43 44 /* range 0x3c-0x58 - MODEM */ 45 #define AC97_EXTENDED_MODEM_ID 0x003C 46 #define AC97_EXTEND_MODEM_STAT 0x003E 47 #define AC97_LINE1_RATE 0x0040 48 #define AC97_LINE2_RATE 0x0042 49 #define AC97_HANDSET_RATE 0x0044 50 #define AC97_LINE1_LEVEL 0x0046 51 #define AC97_LINE2_LEVEL 0x0048 52 #define AC97_HANDSET_LEVEL 0x004A 53 #define AC97_GPIO_CONFIG 0x004C 54 #define AC97_GPIO_POLARITY 0x004E 55 #define AC97_GPIO_STICKY 0x0050 56 #define AC97_GPIO_WAKE_UP 0x0052 57 #define AC97_GPIO_STATUS 0x0054 58 #define AC97_MISC_MODEM_STAT 0x0056 59 #define AC97_RESERVED_58 0x0058 60 61 /* registers 0x005a - 0x007a are vendor reserved */ 62 63 #define AC97_VENDOR_ID1 0x007c 64 #define AC97_VENDOR_ID2 0x007e 65 66 /* volume control bit defines */ 67 #define AC97_MUTE 0x8000 68 #define AC97_MICBOOST 0x0040 69 #define AC97_LEFTVOL 0x3f00 70 #define AC97_RIGHTVOL 0x003f 71 72 /* record mux defines */ 73 #define AC97_RECMUX_MIC 0x0000 74 #define AC97_RECMUX_CD 0x0101 75 #define AC97_RECMUX_VIDEO 0x0202 76 #define AC97_RECMUX_AUX 0x0303 77 #define AC97_RECMUX_LINE 0x0404 78 #define AC97_RECMUX_STEREO_MIX 0x0505 79 #define AC97_RECMUX_MONO_MIX 0x0606 80 #define AC97_RECMUX_PHONE 0x0707 81 82 /* general purpose register bit defines */ 83 #define AC97_GP_LPBK 0x0080 /* Loopback mode */ 84 #define AC97_GP_MS 0x0100 /* Mic Select 0=Mic1, 1=Mic2 */ 85 #define AC97_GP_MIX 0x0200 /* Mono output select 0=Mix, 1=Mic */ 86 #define AC97_GP_RLBK 0x0400 /* Remote Loopback - Modem line codec */ 87 #define AC97_GP_LLBK 0x0800 /* Local Loopback - Modem Line codec */ 88 #define AC97_GP_LD 0x1000 /* Loudness 1=on */ 89 #define AC97_GP_3D 0x2000 /* 3D Enhancement 1=on */ 90 #define AC97_GP_ST 0x4000 /* Stereo Enhancement 1=on */ 91 #define AC97_GP_POP 0x8000 /* Pcm Out Path, 0=pre 3D, 1=post 3D */ 92 93 /* extended audio status and control bit defines */ 94 #define AC97_EA_VRA 0x0001 /* Variable bit rate enable bit */ 95 #define AC97_EA_DRA 0x0002 /* Double-rate audio enable bit */ 96 #define AC97_EA_SPDIF 0x0004 /* S/PDIF Enable bit */ 97 #define AC97_EA_VRM 0x0008 /* Variable bit rate for MIC enable bit */ 98 #define AC97_EA_CDAC 0x0040 /* PCM Center DAC is ready (Read only) */ 99 #define AC97_EA_SDAC 0x0040 /* PCM Surround DACs are ready (Read only) */ 100 #define AC97_EA_LDAC 0x0080 /* PCM LFE DAC is ready (Read only) */ 101 #define AC97_EA_MDAC 0x0100 /* MIC ADC is ready (Read only) */ 102 #define AC97_EA_SPCV 0x0400 /* S/PDIF configuration valid (Read only) */ 103 #define AC97_EA_PRI 0x0800 /* Turns the PCM Center DAC off */ 104 #define AC97_EA_PRJ 0x1000 /* Turns the PCM Surround DACs off */ 105 #define AC97_EA_PRK 0x2000 /* Turns the PCM LFE DAC off */ 106 #define AC97_EA_PRL 0x4000 /* Turns the MIC ADC off */ 107 #define AC97_EA_SLOT_MASK 0xffcf /* Mask for slot assignment bits */ 108 #define AC97_EA_SPSA_3_4 0x0000 /* Slot assigned to 3 & 4 */ 109 #define AC97_EA_SPSA_7_8 0x0010 /* Slot assigned to 7 & 8 */ 110 #define AC97_EA_SPSA_6_9 0x0020 /* Slot assigned to 6 & 9 */ 111 #define AC97_EA_SPSA_10_11 0x0030 /* Slot assigned to 10 & 11 */ 112 113 /* S/PDIF control bit defines */ 114 #define AC97_SC_PRO 0x0001 /* Professional status */ 115 #define AC97_SC_NAUDIO 0x0002 /* Non audio stream */ 116 #define AC97_SC_COPY 0x0004 /* Copyright status */ 117 #define AC97_SC_PRE 0x0008 /* Preemphasis status */ 118 #define AC97_SC_CC_MASK 0x07f0 /* Category Code mask */ 119 #define AC97_SC_L 0x0800 /* Generation Level status */ 120 #define AC97_SC_SPSR_MASK 0xcfff /* S/PDIF Sample Rate bits */ 121 #define AC97_SC_SPSR_44K 0x0000 /* Use 44.1kHz Sample rate */ 122 #define AC97_SC_SPSR_48K 0x2000 /* Use 48kHz Sample rate */ 123 #define AC97_SC_SPSR_32K 0x3000 /* Use 32kHz Sample rate */ 124 #define AC97_SC_DRS 0x4000 /* Double Rate S/PDIF */ 125 #define AC97_SC_V 0x8000 /* Validity status */ 126 127 /* powerdown control and status bit defines */ 128 129 /* status */ 130 #define AC97_PWR_MDM 0x0010 /* Modem section ready */ 131 #define AC97_PWR_REF 0x0008 /* Vref nominal */ 132 #define AC97_PWR_ANL 0x0004 /* Analog section ready */ 133 #define AC97_PWR_DAC 0x0002 /* DAC section ready */ 134 #define AC97_PWR_ADC 0x0001 /* ADC section ready */ 135 136 /* control */ 137 #define AC97_PWR_PR0 0x0100 /* ADC and Mux powerdown */ 138 #define AC97_PWR_PR1 0x0200 /* DAC powerdown */ 139 #define AC97_PWR_PR2 0x0400 /* Output mixer powerdown (Vref on) */ 140 #define AC97_PWR_PR3 0x0800 /* Output mixer powerdown (Vref off) */ 141 #define AC97_PWR_PR4 0x1000 /* AC-link powerdown */ 142 #define AC97_PWR_PR5 0x2000 /* Internal Clk disable */ 143 #define AC97_PWR_PR6 0x4000 /* HP amp powerdown */ 144 #define AC97_PWR_PR7 0x8000 /* Modem off - if supported */ 145 146 /* extended audio ID register bit defines */ 147 #define AC97_EXTID_VRA 0x0001 148 #define AC97_EXTID_DRA 0x0002 149 #define AC97_EXTID_SPDIF 0x0004 150 #define AC97_EXTID_VRM 0x0008 151 #define AC97_EXTID_DSA0 0x0010 152 #define AC97_EXTID_DSA1 0x0020 153 #define AC97_EXTID_CDAC 0x0040 154 #define AC97_EXTID_SDAC 0x0080 155 #define AC97_EXTID_LDAC 0x0100 156 #define AC97_EXTID_AMAP 0x0200 157 #define AC97_EXTID_REV0 0x0400 158 #define AC97_EXTID_REV1 0x0800 159 #define AC97_EXTID_ID0 0x4000 160 #define AC97_EXTID_ID1 0x8000 161 162 /* extended status register bit defines */ 163 #define AC97_EXTSTAT_VRA 0x0001 164 #define AC97_EXTSTAT_DRA 0x0002 165 #define AC97_EXTSTAT_SPDIF 0x0004 166 #define AC97_EXTSTAT_VRM 0x0008 167 #define AC97_EXTSTAT_SPSA0 0x0010 168 #define AC97_EXTSTAT_SPSA1 0x0020 169 #define AC97_EXTSTAT_CDAC 0x0040 170 #define AC97_EXTSTAT_SDAC 0x0080 171 #define AC97_EXTSTAT_LDAC 0x0100 172 #define AC97_EXTSTAT_MADC 0x0200 173 #define AC97_EXTSTAT_SPCV 0x0400 174 #define AC97_EXTSTAT_PRI 0x0800 175 #define AC97_EXTSTAT_PRJ 0x1000 176 #define AC97_EXTSTAT_PRK 0x2000 177 #define AC97_EXTSTAT_PRL 0x4000 178 179 /* useful power states */ 180 #define AC97_PWR_D0 0x0000 /* everything on */ 181 #define AC97_PWR_D1 AC97_PWR_PR0|AC97_PWR_PR1|AC97_PWR_PR4 182 #define AC97_PWR_D2 AC97_PWR_PR0|AC97_PWR_PR1|AC97_PWR_PR2|AC97_PWR_PR3|AC97_PWR_PR4 183 #define AC97_PWR_D3 AC97_PWR_PR0|AC97_PWR_PR1|AC97_PWR_PR2|AC97_PWR_PR3|AC97_PWR_PR4 184 #define AC97_PWR_ANLOFF AC97_PWR_PR2|AC97_PWR_PR3 /* analog section off */ 185 186 /* Total number of defined registers. */ 187 #define AC97_REG_CNT 64 188 189 190 /* OSS interface to the ac97s.. */ 191 #define AC97_STEREO_MASK (SOUND_MASK_VOLUME|SOUND_MASK_PCM|\ 192 SOUND_MASK_LINE|SOUND_MASK_CD|\ 193 SOUND_MASK_ALTPCM|SOUND_MASK_IGAIN|\ 194 SOUND_MASK_LINE1|SOUND_MASK_VIDEO) 195 196 #define AC97_SUPPORTED_MASK (AC97_STEREO_MASK | \ 197 SOUND_MASK_BASS|SOUND_MASK_TREBLE|\ 198 SOUND_MASK_SPEAKER|SOUND_MASK_MIC|\ 199 SOUND_MASK_PHONEIN|SOUND_MASK_PHONEOUT) 200 201 #define AC97_RECORD_MASK (SOUND_MASK_MIC|\ 202 SOUND_MASK_CD|SOUND_MASK_IGAIN|SOUND_MASK_VIDEO|\ 203 SOUND_MASK_LINE1| SOUND_MASK_LINE|\ 204 SOUND_MASK_PHONEIN) 205 206 /* original check is not good enough in case FOO is greater than 207 * SOUND_MIXER_NRDEVICES because the supported_mixers has exactly 208 * SOUND_MIXER_NRDEVICES elements. 209 * before matching the given mixer against the bitmask in supported_mixers we 210 * check if mixer number exceeds maximum allowed size which is as mentioned 211 * above SOUND_MIXER_NRDEVICES */ 212 #define supported_mixer(CODEC,FOO) ((FOO >= 0) && \ 213 (FOO < SOUND_MIXER_NRDEVICES) && \ 214 (CODEC)->supported_mixers & (1<<FOO) ) 215 216 struct ac97_codec { 217 /* Linked list of codecs */ 218 struct list_head list; 219 220 /* AC97 controller connected with */ 221 void *private_data; 222 223 char *name; 224 int id; 225 int dev_mixer; 226 int type; 227 u32 model; 228 229 int modem:1; 230 231 struct ac97_ops *codec_ops; 232 233 /* controller specific lower leverl ac97 accessing routines. 234 must be re-entrant safe */ 235 u16 (*codec_read) (struct ac97_codec *codec, u8 reg); 236 void (*codec_write) (struct ac97_codec *codec, u8 reg, u16 val); 237 238 /* Wait for codec-ready. Ok to sleep here. */ 239 void (*codec_wait) (struct ac97_codec *codec); 240 241 /* callback used by helper drivers for interesting ac97 setups */ 242 void (*codec_unregister) (struct ac97_codec *codec); 243 244 struct ac97_driver *driver; 245 void *driver_private; /* Private data for the driver */ 246 247 spinlock_t lock; 248 249 /* OSS mixer masks */ 250 int modcnt; 251 int supported_mixers; 252 int stereo_mixers; 253 int record_sources; 254 255 /* Property flags */ 256 int flags; 257 258 int bit_resolution; 259 260 /* OSS mixer interface */ 261 int (*read_mixer) (struct ac97_codec *codec, int oss_channel); 262 void (*write_mixer)(struct ac97_codec *codec, int oss_channel, 263 unsigned int left, unsigned int right); 264 int (*recmask_io) (struct ac97_codec *codec, int rw, int mask); 265 int (*mixer_ioctl)(struct ac97_codec *codec, unsigned int cmd, unsigned long arg); 266 267 /* saved OSS mixer states */ 268 unsigned int mixer_state[SOUND_MIXER_NRDEVICES]; 269 270 /* Software Modem interface */ 271 int (*modem_ioctl)(struct ac97_codec *codec, unsigned int cmd, unsigned long arg); 272 }; 273 274 /* 275 * Operation structures for each known AC97 chip 276 */ 277 278 struct ac97_ops 279 { 280 /* Initialise */ 281 int (*init)(struct ac97_codec *c); 282 /* Amplifier control */ 283 int (*amplifier)(struct ac97_codec *codec, int on); 284 /* Digital mode control */ 285 int (*digital)(struct ac97_codec *codec, int slots, int rate, int mode); 286 #define AUDIO_DIGITAL 0x8000 287 #define AUDIO_PRO 0x4000 288 #define AUDIO_DRS 0x2000 289 #define AUDIO_CCMASK 0x003F 290 291 #define AC97_DELUDED_MODEM 1 /* Audio codec reports its a modem */ 292 #define AC97_NO_PCM_VOLUME 2 /* Volume control is missing */ 293 #define AC97_DEFAULT_POWER_OFF 4 /* Needs warm reset to power up */ 294 }; 295 296 extern int ac97_read_proc (char *page_out, char **start, off_t off, 297 int count, int *eof, void *data); 298 extern int ac97_probe_codec(struct ac97_codec *); 299 extern unsigned int ac97_set_adc_rate(struct ac97_codec *codec, unsigned int rate); 300 extern unsigned int ac97_set_dac_rate(struct ac97_codec *codec, unsigned int rate); 301 extern int ac97_save_state(struct ac97_codec *codec); 302 extern int ac97_restore_state(struct ac97_codec *codec); 303 304 extern struct ac97_codec *ac97_alloc_codec(void); 305 extern void ac97_release_codec(struct ac97_codec *codec); 306 307 struct ac97_driver { 308 struct list_head list; 309 char *name; 310 u32 codec_id; 311 u32 codec_mask; 312 int (*probe) (struct ac97_codec *codec, struct ac97_driver *driver); 313 void (*remove) (struct ac97_codec *codec, struct ac97_driver *driver); 314 }; 315 316 extern int ac97_register_driver(struct ac97_driver *driver); 317 extern void ac97_unregister_driver(struct ac97_driver *driver); 318 319 #endif /* _AC97_CODEC_H_ */ 320