1 /* $OpenBSD: ac97.h,v 1.26 2016/09/14 06:12:19 ratchov Exp $ */ 2 3 /* 4 * Copyright (c) 1999 Constantine Sapuntzakis 5 * 6 * Author: Constantine Sapuntzakis <csapuntz@stanford.edu> 7 * 8 * Redistribution and use in source and binary forms, with or without 9 * modification, are permitted provided that the following conditions 10 * are met: 11 * 1. Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * THIS SOFTWARE IS PROVIDED BY CONSTANTINE SAPUNTZAKIS AND CONTRIBUTORS 18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS 21 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27 * POSSIBILITY OF SUCH DAMAGE. 28 */ 29 30 struct ac97_codec_if; 31 32 /* 33 * This is the interface used to attach the AC97 compliant CODEC. 34 */ 35 enum ac97_host_flags { 36 AC97_HOST_DONT_READ = 0x1, 37 AC97_HOST_DONT_READANY = 0x2, 38 AC97_HOST_SWAPPED_CHANNELS = 0x4, 39 AC97_HOST_ALC650_PIN47_IS_EAPD = 0x8, 40 AC97_HOST_VT1616_DYNEX = 0x10 41 }; 42 43 struct ac97_host_if { 44 void *arg; 45 46 int (*attach)(void *arg, struct ac97_codec_if *codecif); 47 int (*read)(void *arg, u_int8_t reg, u_int16_t *val); 48 int (*write)(void *arg, u_int8_t reg, u_int16_t val); 49 void (*reset)(void *arg); 50 51 enum ac97_host_flags (*flags)(void *arg); 52 void (*spdif_event)(void *arg, int); 53 }; 54 55 /* 56 * This is the interface exported by the AC97 compliant CODEC 57 */ 58 59 struct ac97_codec_if_vtbl { 60 int (*mixer_get_port)(struct ac97_codec_if *addr, mixer_ctrl_t *cp); 61 int (*mixer_set_port)(struct ac97_codec_if *addr, mixer_ctrl_t *cp); 62 int (*query_devinfo)(struct ac97_codec_if *addr, mixer_devinfo_t *cp); 63 int (*get_portnum_by_name)(struct ac97_codec_if *addr, char *class, 64 char *device, char *qualifier); 65 66 /* 67 * The AC97 codec driver records the various port settings. 68 * This function can be used to restore the port settings, e.g. 69 * after resume from a laptop suspend to disk. 70 */ 71 void (*restore_ports)(struct ac97_codec_if *addr); 72 73 u_int16_t (*get_caps)(struct ac97_codec_if *codec_if); 74 int (*set_rate)(struct ac97_codec_if *codec_if, int target, 75 u_long *rate); 76 void (*set_clock)(struct ac97_codec_if *codec_if, 77 unsigned int clock); 78 void (*lock)(struct ac97_codec_if *codec_if); 79 void (*unlock)(struct ac97_codec_if *codec_if); 80 }; 81 82 struct ac97_codec_if { 83 struct ac97_softc *as; 84 void (*initfunc)(struct ac97_softc *, int); 85 struct ac97_codec_if_vtbl *vtbl; 86 }; 87 88 int ac97_attach(struct ac97_host_if *); 89 int ac97_resume(struct ac97_host_if *, struct ac97_codec_if *); 90 int ac97_set_rate(struct ac97_codec_if *, int, u_long *); 91 92 #define AC97_REG_RESET 0x00 93 #define AC97_CAPS_MICIN 0x0001 94 #define AC97_CAPS_TONECTRL 0x0004 95 #define AC97_CAPS_SIMSTEREO 0x0008 96 #define AC97_CAPS_HEADPHONES 0x0010 97 #define AC97_CAPS_LOUDNESS 0x0020 98 #define AC97_CAPS_DAC18 0x0040 99 #define AC97_CAPS_DAC20 0x0080 100 #define AC97_CAPS_ADC18 0x0100 101 #define AC97_CAPS_ADC20 0x0200 102 #define AC97_CAPS_ENHANCEMENT_MASK 0xfc00 103 #define AC97_CAPS_ENHANCEMENT_SHIFT 10 104 #define AC97_CAPS_ENHANCEMENT(reg) (((reg) >> 10) & 0x1f) 105 #define AC97_REG_MASTER_VOLUME 0x02 106 #define AC97_REG_HEADPHONE_VOLUME 0x04 107 #define AC97_REG_MASTER_VOLUME_MONO 0x06 108 #define AC97_REG_MASTER_TONE 0x08 109 #define AC97_REG_PCBEEP_VOLUME 0x0a 110 #define AC97_REG_PHONE_VOLUME 0x0c 111 #define AC97_REG_MIC_VOLUME 0x0e 112 #define AC97_REG_LINEIN_VOLUME 0x10 113 #define AC97_REG_CD_VOLUME 0x12 114 #define AC97_REG_VIDEO_VOLUME 0x14 115 #define AC97_REG_AUX_VOLUME 0x16 116 #define AC97_REG_PCMOUT_VOLUME 0x18 117 #define AC97_REG_RECORD_SELECT 0x1a 118 #define AC97_REG_RECORD_GAIN 0x1c 119 #define AC97_REG_RECORD_GAIN_MIC 0x1e 120 #define AC97_REG_GP 0x20 121 #define AC97_REG_3D_CONTROL 0x22 122 #define AC97_REG_MODEM_SAMPLE_RATE 0x24 123 #define AC97_REG_POWER 0x26 124 #define AC97_POWER_ADC 0x0001 125 #define AC97_POWER_DAC 0x0002 126 #define AC97_POWER_ANL 0x0004 127 #define AC97_POWER_REF 0x0008 128 #define AC97_POWER_IN 0x0100 129 #define AC97_POWER_OUT 0x0200 130 #define AC97_POWER_MIXER 0x0400 131 #define AC97_POWER_MIXER_VREF 0x0800 132 #define AC97_POWER_ACLINK 0x1000 133 #define AC97_POWER_CLK 0x2000 134 #define AC97_POWER_AUX 0x4000 135 #define AC97_POWER_EAMP 0x8000 136 /* Extended Audio Register Set */ 137 #define AC97_REG_EXT_AUDIO_ID 0x28 138 #define AC97_REG_EXT_AUDIO_CTRL 0x2a 139 #define AC97_EXT_AUDIO_VRA 0x0001 140 #define AC97_EXT_AUDIO_DRA 0x0002 141 #define AC97_EXT_AUDIO_SPDIF 0x0004 142 #define AC97_EXT_AUDIO_VRM 0x0008 143 #define AC97_EXT_AUDIO_DSA_MASK 0x0030 144 #define AC97_EXT_AUDIO_DSA00 0x0000 145 #define AC97_EXT_AUDIO_DSA01 0x0010 146 #define AC97_EXT_AUDIO_DSA10 0x0020 147 #define AC97_EXT_AUDIO_DSA11 0x0030 148 #define AC97_EXT_AUDIO_SPSA_MASK 0x0030 149 #define AC97_EXT_AUDIO_SPSA34 0x0000 150 #define AC97_EXT_AUDIO_SPSA78 0x0010 151 #define AC97_EXT_AUDIO_SPSA69 0x0020 152 #define AC97_EXT_AUDIO_SPSAAB 0x0030 153 #define AC97_EXT_AUDIO_CDAC 0x0040 154 #define AC97_EXT_AUDIO_SDAC 0x0080 155 #define AC97_EXT_AUDIO_LDAC 0x0100 156 #define AC97_EXT_AUDIO_AMAP 0x0200 157 #define AC97_EXT_AUDIO_SPCV 0x0400 158 #define AC97_EXT_AUDIO_REV_11 0x0000 159 #define AC97_EXT_AUDIO_REV_22 0x0400 160 #define AC97_EXT_AUDIO_REV_23 0x0800 161 #define AC97_EXT_AUDIO_REV_MASK 0x0c00 162 #define AC97_EXT_AUDIO_ID 0xc000 163 #define AC97_EXT_AUDIO_BITS "\020\01vra\02dra\03spdif\04vrm\05dsa0\06dsa1\07cdac\010sdac\011ldac\012amap\013rev0\014rev1\017id0\020id1" 164 #define AC97_SINGLE_RATE 48000 165 #define AC97_REG_PCM_FRONT_DAC_RATE 0x2c 166 #define AC97_REG_PCM_SURR_DAC_RATE 0x2e 167 #define AC97_REG_PCM_LFE_DAC_RATE 0x30 168 #define AC97_REG_PCM_LR_ADC_RATE 0x32 169 #define AC97_REG_PCM_MIC_ADC_RATE 0x34 170 #define AC97_REG_CENTER_LFE_MASTER 0x36 171 #define AC97_REG_SURR_MASTER 0x38 172 #define AC97_REG_SPDIF_CTRL 0x3a 173 #define AC97_REG_SPDIF_CTRL_BITS "\02\01pro\02/audio\03copy\04pre\014l\017drs\020valid" 174 #define AC97_SPDIF_V 0x8000 175 #define AC97_SPDIF_DRS 0x4000 176 #define AC97_SPDIF_SPSR_MASK 0x3000 177 #define AC97_SPDIF_SPSR_44K 0x0000 178 #define AC97_SPDIF_SPSR_48K 0x2000 179 #define AC97_SPDIF_SPSR_32K 0x1000 180 #define AC97_SPDIF_L 0x0800 181 #define AC97_SPDIF_CC_MASK 0x07f0 182 #define AC97_SPDIF_PRE 0x0008 183 #define AC97_SPDIF_COPY 0x0004 184 #define AC97_SPDIF_NOAUDIO 0x0002 185 #define AC97_SPDIF_PRO 0x0001 186 187 #define AC97_REG_VENDOR_ID1 0x7c 188 #define AC97_REG_VENDOR_ID2 0x7e 189 #define AC97_VENDOR_ID_MASK 0xffffff00 190 191 192 /* Analog Devices codec specific data */ 193 #define AC97_AD_REG_MISC 0x76 194 #define AC97_AD_MISC_MBG0 0x0001 /* 0 */ 195 #define AC97_AD_MISC_MBG1 0x0002 /* 1 */ 196 #define AC97_AD_MISC_VREFD 0x0004 /* 2 */ 197 #define AC97_AD_MISC_VREFH 0x0008 /* 3 */ 198 #define AC97_AD_MISC_SRU 0x0010 /* 4 */ 199 #define AC97_AD_MISC_LOSEL 0x0020 /* 5 */ 200 #define AC97_AD_MISC_2CMIC 0x0040 /* 6 */ 201 #define AC97_AD_MISC_SPRD 0x0080 /* 7 */ 202 #define AC97_AD_MISC_DMIX0 0x0100 /* 8 */ 203 #define AC97_AD_MISC_DMIX1 0x0200 /* 9 */ 204 #define AC97_AD_MISC_HPSEL 0x0400 /*10 */ 205 #define AC97_AD_MISC_CLDIS 0x0800 /*11 */ 206 #define AC97_AD_MISC_LODIS 0x1000 /*12 */ 207 #define AC97_AD_MISC_MSPLT 0x2000 /*13 */ 208 #define AC97_AD_MISC_AC97NC 0x4000 /*14 */ 209 #define AC97_AD_MISC_DACZ 0x8000 /*15 */ 210 211 /* Avance Logic codec specific data*/ 212 #define AC97_ALC650_REG_MULTI_CHANNEL_CONTROL 0x6a 213 #define AC97_ALC650_MCC_SLOT_MODIFY_MASK 0xc000 214 #define AC97_ALC650_MCC_FRONTDAC_FROM_SPDIFIN 0x2000 215 #define AC97_ALC650_MCC_SPDIFOUT_FROM_ADC 0x1000 216 #define AC97_ALC650_MCC_PCM_FROM_SPDIFIN 0x0800 217 #define AC97_ALC650_MCC_MIC_OR_CENTERLFE 0x0400 218 #define AC97_ALC650_MCC_LINEIN_OR_SURROUND 0x0200 219 #define AC97_ALC650_MCC_INDEPENDENT_MASTER_L 0x0080 220 #define AC97_ALC650_MCC_INDEPENDENT_MASTER_R 0x0040 221 #define AC97_ALC650_MCC_ANALOG_TO_CENTERLFE 0x0020 222 #define AC97_ALC650_MCC_ANALOG_TO_SURROUND 0x0010 223 #define AC97_ALC650_MCC_EXCHANGE_CENTERLFE 0x0008 224 #define AC97_ALC650_MCC_CENTERLFE_DOWNMIX 0x0004 225 #define AC97_ALC650_MCC_SURROUND_DOWNMIX 0x0002 226 #define AC97_ALC650_MCC_LINEOUT_TO_SURROUND 0x0001 227 #define AC97_ALC650_REG_MISC 0x7a 228 #define AC97_ALC650_MISC_PIN47 0x0002 229 #define AC97_ALC650_MISC_VREFDIS 0x1000 230 231 232 /* Conexant codec specific data */ 233 #define AC97_CX_REG_MISC 0x5c 234 #define AC97_CX_PCM 0x00 235 #define AC97_CX_AC3 0x02 236 #define AC97_CX_MASK 0x03 237 #define AC97_CX_COPYRIGHT 0x04 238 #define AC97_CX_SPDIFEN 0x08 239 240 241 /* VIA codec specific data */ 242 #define AC97_VT_REG_TEST 0x5a 243 #define AC97_VT_LVL 0x8000 /* hp controls rear */ 244 #define AC97_VT_LCTF 0x1000 /* lfe/center to front downmix */ 245 #define AC97_VT_STF 0x0800 /* surround to front downmix */ 246 #define AC97_VT_BPDC 0x0400 /* enable DC-offset cancellation */ 247 #define AC97_VT_DC 0x0200 /* DC offset cancellation capable */ 248 249 #define AC97_IS_FIXED_RATE(codec) !((codec)->vtbl->get_caps(codec) & \ 250 AC97_EXT_AUDIO_VRA) 251 #define AC97_BITS_6CH (AC97_EXT_AUDIO_SDAC | AC97_EXT_AUDIO_CDAC | \ 252 AC97_EXT_AUDIO_LDAC) 253