1 /* $OpenBSD: ac97.h,v 1.10 2001/10/28 19:07:24 mickey 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 struct ac97_host_if { 36 void *arg; 37 38 int (*attach)(void *arg, struct ac97_codec_if *codecif); 39 int (*read)(void *arg, u_int8_t reg, u_int16_t *val); 40 int (*write)(void *arg, u_int8_t reg, u_int16_t val); 41 void (*reset)(void *arg); 42 43 enum ac97_host_flags { 44 AC97_HOST_DONT_READ = 0x1, 45 AC97_HOST_DONT_READANY = 0x2 46 }; 47 48 enum ac97_host_flags (*flags)(void *arg); 49 }; 50 51 /* 52 * This is the interface exported by the AC97 compliant CODEC 53 */ 54 55 struct ac97_codec_if_vtbl { 56 int (*mixer_get_port)(struct ac97_codec_if *addr, mixer_ctrl_t *cp); 57 int (*mixer_set_port)(struct ac97_codec_if *addr, mixer_ctrl_t *cp); 58 int (*query_devinfo)(struct ac97_codec_if *addr, mixer_devinfo_t *cp); 59 int (*get_portnum_by_name)(struct ac97_codec_if *addr, char *class, 60 char *device, char *qualifier); 61 62 /* 63 * The AC97 codec driver records the various port settings. 64 * This function can be used to restore the port settings, e.g. 65 * after resume from a laptop suspend to disk. 66 */ 67 void (*restore_ports)(struct ac97_codec_if *addr); 68 }; 69 70 struct ac97_codec_if { 71 struct ac97_codec_if_vtbl *vtbl; 72 }; 73 74 int ac97_attach __P((struct ac97_host_if *)); 75 int ac97_set_rate __P((struct ac97_codec_if *, struct audio_params *, int)); 76 77 #define AC97_REG_RESET 0x00 78 #define AC97_CAPS_MICIN 0x0001 79 #define AC97_CAPS_TONECTRL 0x0004 80 #define AC97_CAPS_SIMSTEREO 0x0008 81 #define AC97_CAPS_HEADPHONES 0x0010 82 #define AC97_CAPS_LOUDNESS 0x0020 83 #define AC97_CAPS_DAC18 0x0040 84 #define AC97_CAPS_DAC20 0x0080 85 #define AC97_CAPS_ADC18 0x0100 86 #define AC97_CAPS_ADC20 0x0200 87 #define AC97_CAPS_ENHANCEMENT_MASK 0xfc00 88 #define AC97_CAPS_ENHANCEMENT_SHIFT 10 89 #define AC97_CAPS_ENHANCEMENT(reg) (((reg) >> 10) & 0x1f) 90 #define AC97_REG_MASTER_VOLUME 0x02 91 #define AC97_REG_HEADPHONE_VOLUME 0x04 92 #define AC97_REG_MASTER_VOLUME_MONO 0x06 93 #define AC97_REG_MASTER_TONE 0x08 94 #define AC97_REG_PCBEEP_VOLUME 0x0a 95 #define AC97_REG_PHONE_VOLUME 0x0c 96 #define AC97_REG_MIC_VOLUME 0x0e 97 #define AC97_REG_LINEIN_VOLUME 0x10 98 #define AC97_REG_CD_VOLUME 0x12 99 #define AC97_REG_VIDEO_VOLUME 0x14 100 #define AC97_REG_AUX_VOLUME 0x16 101 #define AC97_REG_PCMOUT_VOLUME 0x18 102 #define AC97_REG_RECORD_SELECT 0x1a 103 #define AC97_REG_RECORD_GAIN 0x1c 104 #define AC97_REG_RECORD_GAIN_MIC 0x1e 105 #define AC97_REG_GP 0x20 106 #define AC97_REG_3D_CONTROL 0x22 107 #define AC97_REG_MODEM_SAMPLE_RATE 0x24 108 #define AC97_REG_POWER 0x26 109 #define AC97_POWER_ADC 0x0001 110 #define AC97_POWER_DAC 0x0002 111 #define AC97_POWER_ANL 0x0004 112 #define AC97_POWER_REF 0x0008 113 #define AC97_POWER_IN 0x0100 114 #define AC97_POWER_OUT 0x0200 115 #define AC97_POWER_MIXER 0x0400 116 #define AC97_POWER_MIXER_VREF 0x0800 117 #define AC97_POWER_ACLINK 0x1000 118 #define AC97_POWER_CLK 0x2000 119 #define AC97_POWER_AUX 0x4000 120 #define AC97_POWER_EAMP 0x8000 121 /* Extended Audio Register Set */ 122 #define AC97_REG_EXT_AUDIO_ID 0x28 123 #define AC97_REG_EXT_AUDIO_CTRL 0x2a 124 #define AC97_EXT_AUDIO_VRA 0x0001 125 #define AC97_EXT_AUDIO_DRA 0x0002 126 #define AC97_EXT_AUDIO_SPDIF 0x0004 127 #define AC97_EXT_AUDIO_VRM 0x0008 128 #define AC97_EXT_AUDIO_DSA 0x0030 129 #define AC97_EXT_AUDIO_CDAC 0x0040 130 #define AC97_EXT_AUDIO_SDAC 0x0080 131 #define AC97_EXT_AUDIO_LDAC 0x0100 132 #define AC97_EXT_AUDIO_AMAP 0x0200 133 #define AC97_EXT_AUDIO_REV_11 0x0000 134 #define AC97_EXT_AUDIO_REV_22 0x0400 135 #define AC97_EXT_AUDIO_REV_MASK 0x0c00 136 #define AC97_EXT_AUDIO_ID 0xc000 137 #define AC97_EXT_AUDIO_BITS "\020\01vra\02dra\03spdif\04vrm\05dsa0\06dsa1\07cdac\010sdac\011ldac\012amap\013rev0\014rev1\017id0\020id1" 138 #define AC97_SINGLERATE 48000 139 #define AC97_REG_FRONT_DAC_RATE 0x2c 140 #define AC97_REG_SURROUND_DAC_RATE 0x2e 141 #define AC97_REG_PCM_DAC_RATE 0x30 142 #define AC97_REG_PCM_ADC_RATE 0x32 143 #define AC97_REG_MIC_ADC_RATE 0x34 144 #define AC97_REG_CENTER_LFE_VOLUME 0x36 145 #define AC97_REG_SURROUND_VOLUME 0x38 146 #define AC97_REG_SPDIF_CTRL 0x3a 147 #define AC97_REG_SPDIF_CTRL_BITS "\02\01pro\02/audio\03copy\04pre\014l\017drs\020valid" 148 149 #define AC97_REG_VENDOR_ID1 0x7c 150 #define AC97_REG_VENDOR_ID2 0x7e 151 #define AC97_VENDOR_ID_MASK 0xffffff00 152 153