sound/pci/ac97/ac97_local.h

   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 struct snd_kcontrol_new snd_ac97_controls_3d[];
  61 extern const struct snd_kcontrol_new snd_ac97_controls_spdif[];
  62 struct snd_kcontrol *snd_ac97_cnew(const struct snd_kcontrol_new *_template, struct snd_ac97 * ac97);
  63 void snd_ac97_get_name(struct snd_ac97 *ac97, unsigned int id, char *name, int modem);
  64 int snd_ac97_info_volsw(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo);
  65 int snd_ac97_get_volsw(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
  66 int snd_ac97_put_volsw(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
  67 int snd_ac97_try_bit(struct snd_ac97 * ac97, int reg, int bit);
  68 int snd_ac97_remove_ctl(struct snd_ac97 *ac97, const char *name, const char *suffix);
  69 int snd_ac97_rename_ctl(struct snd_ac97 *ac97, const char *src, const char *dst, const char *suffix);
  70 int snd_ac97_swap_ctl(struct snd_ac97 *ac97, const char *s1, const char *s2, const char *suffix);
  71 void snd_ac97_rename_vol_ctl(struct snd_ac97 *ac97, const char *src, const char *dst);
  72 void snd_ac97_restore_status(struct snd_ac97 *ac97);
  73 void snd_ac97_restore_iec958(struct snd_ac97 *ac97);
  74 int snd_ac97_info_enum_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo);
  75 int snd_ac97_get_enum_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
  76 int snd_ac97_put_enum_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol);
  77
  78 int snd_ac97_update_bits_nolock(struct snd_ac97 *ac97, unsigned short reg,
  79                                 unsigned short mask, unsigned short value);
  80
  81 /* ac97_proc.c */
  82 #ifdef CONFIG_PROC_FS
  83 void snd_ac97_bus_proc_init(struct snd_ac97_bus * ac97);
  84 void snd_ac97_bus_proc_done(struct snd_ac97_bus * ac97);
  85 void snd_ac97_proc_init(struct snd_ac97 * ac97);
  86 void snd_ac97_proc_done(struct snd_ac97 * ac97);
  87 #else
  88 #define snd_ac97_bus_proc_init(ac97_bus_t) do { } while (0)
  89 #define snd_ac97_bus_proc_done(ac97_bus_t) do { } while (0)
  90 #define snd_ac97_proc_init(ac97_t) do { } while (0)
  91 #define snd_ac97_proc_done(ac97_t) do { } while (0)
  92 #endif