1 /* 2 * Copyright (c) by Jaroslav Kysela <perex@suse.cz> 3 * Universal interface for Audio Codec '97 4 * 5 * For more details look to AC '97 component specification revision 2.2 6 * by Intel Corporation (http://developer.intel.com). 7 * 8 * 9 * This program is free software; you can redistribute it and/or modify 10 * it under the terms of the GNU General Public License as published by 11 * the Free Software Foundation; either version 2 of the License, or 12 * (at your option) any later version. 13 * 14 * This program is distributed in the hope that it will be useful, 15 * but WITHOUT ANY WARRANTY; without even the implied warranty of 16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 17 * GNU General Public License for more details. 18 * 19 * You should have received a copy of the GNU General Public License 20 * along with this program; if not, write to the Free Software 21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 22 * 23 */ 24 25 #define AC97_SINGLE_VALUE(reg,shift,mask,invert) ((reg) | ((shift) << 8) | ((shift) << 12) | ((mask) << 16) | ((invert) << 24)) 26 #define AC97_PAGE_SINGLE_VALUE(reg,shift,mask,invert,page) (AC97_SINGLE_VALUE(reg,shift,mask,invert) | (1<<25) | ((page) << 26)) 27 #define AC97_SINGLE(xname, reg, shift, mask, invert) \ 28 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .info = snd_ac97_info_volsw, \ 29 .get = snd_ac97_get_volsw, .put = snd_ac97_put_volsw, \ 30 .private_value = AC97_SINGLE_VALUE(reg, shift, mask, invert) } 31 #define AC97_PAGE_SINGLE(xname, reg, shift, mask, invert, page) \ 32 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .info = snd_ac97_info_volsw, \ 33 .get = snd_ac97_get_volsw, .put = snd_ac97_put_volsw, \ 34 .private_value = AC97_PAGE_SINGLE_VALUE(reg, shift, mask, invert, page) } 35 #define AC97_DOUBLE(xname, reg, shift_left, shift_right, mask, invert) \ 36 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = (xname), .info = snd_ac97_info_volsw, \ 37 .get = snd_ac97_get_volsw, .put = snd_ac97_put_volsw, \ 38 .private_value = (reg) | ((shift_left) << 8) | ((shift_right) << 12) | ((mask) << 16) | ((invert) << 24) } 39 40 /* enum control */ 41 struct ac97_enum { 42 unsigned char reg; 43 unsigned char shift_l; 44 unsigned char shift_r; 45 unsigned short mask; 46 const char **texts; 47 }; 48 49 #define AC97_ENUM_DOUBLE(xreg, xshift_l, xshift_r, xmask, xtexts) \ 50 { .reg = xreg, .shift_l = xshift_l, .shift_r = xshift_r, \ 51 .mask = xmask, .texts = xtexts } 52 #define AC97_ENUM_SINGLE(xreg, xshift, xmask, xtexts) \ 53 AC97_ENUM_DOUBLE(xreg, xshift, xshift, xmask, xtexts) 54 #define AC97_ENUM(xname, xenum) \ 55 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .info = snd_ac97_info_enum_double, \ 56 .get = snd_ac97_get_enum_double, .put = snd_ac97_put_enum_double, \ 57 .private_value = (unsigned long)&xenum } 58 59 /* ac97_codec.c */ 60 extern const char *snd_ac97_stereo_enhancements[]; 61 extern const struct snd_kcontrol_new snd_ac97_controls_3d[]; 62 extern const struct snd_kcontrol_new snd_ac97_controls_spdif[]; 63 struct snd_kcontrol *snd_ac97_cnew(const struct snd_kcontrol_new *_template, struct snd_ac97 * ac97); 64 void snd_ac97_get_name(struct snd_ac97 *ac97, unsigned int id, char *name, int modem); 65 int snd_ac97_info_volsw(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo); 66 int snd_ac97_get_volsw(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol); 67 int snd_ac97_put_volsw(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol); 68 int snd_ac97_try_bit(struct snd_ac97 * ac97, int reg, int bit); 69 int snd_ac97_remove_ctl(struct snd_ac97 *ac97, const char *name, const char *suffix); 70 int snd_ac97_rename_ctl(struct snd_ac97 *ac97, const char *src, const char *dst, const char *suffix); 71 int snd_ac97_swap_ctl(struct snd_ac97 *ac97, const char *s1, const char *s2, const char *suffix); 72 void snd_ac97_rename_vol_ctl(struct snd_ac97 *ac97, const char *src, const char *dst); 73 void snd_ac97_restore_status(struct snd_ac97 *ac97); 74 void snd_ac97_restore_iec958(struct snd_ac97 *ac97); 75 int snd_ac97_info_enum_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo); 76 int snd_ac97_get_enum_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol); 77 int snd_ac97_put_enum_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol); 78 79 int snd_ac97_update_bits_nolock(struct snd_ac97 *ac97, unsigned short reg, 80 unsigned short mask, unsigned short value); 81 82 /* ac97_proc.c */ 83 #ifdef CONFIG_PROC_FS 84 void snd_ac97_bus_proc_init(struct snd_ac97_bus * ac97); 85 void snd_ac97_bus_proc_done(struct snd_ac97_bus * ac97); 86 void snd_ac97_proc_init(struct snd_ac97 * ac97); 87 void snd_ac97_proc_done(struct snd_ac97 * ac97); 88 #else 89 #define snd_ac97_bus_proc_init(ac97_bus_t) do { } while (0) 90 #define snd_ac97_bus_proc_done(ac97_bus_t) do { } while (0) 91 #define snd_ac97_proc_init(ac97_t) do { } while (0) 92 #define snd_ac97_proc_done(ac97_t) do { } while (0) 93 #endif 94