sys/dev/ic/ad1848var.h

   1 /*      $NetBSD: ad1848var.h,v 1.15 2007/12/11 00:21:51 martin Exp $    */
   2
   3 /*-
   4  * Copyright (c) 1999 The NetBSD Foundation, Inc.
   5  * All rights reserved.
   6  *
   7  * This code is derived from software contributed to The NetBSD Foundation
   8  * by Ken Hornstein and John Kohl.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions
  12  * are met:
  13  * 1. Redistributions of source code must retain the above copyright
  14  *    notice, this list of conditions and the following disclaimer.
  15  * 2. Redistributions in binary form must reproduce the above copyright
  16  *    notice, this list of conditions and the following disclaimer in the
  17  *    documentation and/or other materials provided with the distribution.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  29  * POSSIBILITY OF SUCH DAMAGE.
  30  */
  31 /*
  32  * Copyright (c) 1994 John Brezak
  33  * Copyright (c) 1991-1993 Regents of the University of California.
  34  * All rights reserved.
  35  *
  36  * Redistribution and use in source and binary forms, with or without
  37  * modification, are permitted provided that the following conditions
  38  * are met:
  39  * 1. Redistributions of source code must retain the above copyright
  40  *    notice, this list of conditions and the following disclaimer.
  41  * 2. Redistributions in binary form must reproduce the above copyright
  42  *    notice, this list of conditions and the following disclaimer in the
  43  *    documentation and/or other materials provided with the distribution.
  44  * 3. All advertising materials mentioning features or use of this software
  45  *    must display the following acknowledgement:
  46  *      This product includes software developed by the Computer Systems
  47  *      Engineering Group at Lawrence Berkeley Laboratory.
  48  * 4. Neither the name of the University nor of the Laboratory may be used
  49  *    to endorse or promote products derived from this software without
  50  *    specific prior written permission.
  51  *
  52  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  53  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  54  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  55  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  56  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  57  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  58  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  59  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  60  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  61  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  62  * SUCH DAMAGE.
  63  *
  64  */
  65
  66
  67 #define MUTE_LEFT       1
  68 #define MUTE_RIGHT      2
  69 #define MUTE_ALL        (MUTE_LEFT | MUTE_RIGHT)
  70 #define MUTE_MONO       MUTE_ALL
  71
  72 #define WAVE_MUTE0      1               /* force mute (overrides UNMUTE1) */
  73 #define WAVE_UNMUTE1    2               /* unmute (overrides MUTE2) */
  74 #define WAVE_MUTE2      4               /* weak mute */
  75 #define WAVE_MUTE2_INIT 0               /* init and MUTE2 */
  76
  77 /*
  78  * Don't change this ordering without seriously looking around.
  79  * These are indexes into mute[] array and into a register
  80  * information array.
  81  */
  82 #define AD1848_AUX2_CHANNEL     0
  83 #define AD1848_AUX1_CHANNEL     1
  84 #define AD1848_DAC_CHANNEL      2
  85 #define AD1848_LINE_CHANNEL     3
  86 #define AD1848_MONO_CHANNEL     4
  87 #define AD1848_OUT_CHANNEL      5
  88 #define AD1848_MONITOR_CHANNEL  6 /* Doesn't seem to be on all later chips */
  89
  90 #define AD1848_NUM_CHANNELS     7
  91
  92 struct ad1848_volume {
  93         u_char  left;
  94         u_char  right;
  95 };
  96
  97 struct ad1848_softc {
  98         struct  device sc_dev;          /* base device */
  99         bus_space_tag_t sc_iot;         /* tag */
 100         bus_space_handle_t sc_ioh;      /* handle */
 101
 102         int     (*sc_readreg)(struct ad1848_softc *, int);
 103         void    (*sc_writereg)(struct ad1848_softc *, int, int);
 104 #define ADREAD(sc, index)               (*(sc)->sc_readreg)(sc, index)
 105 #define ADWRITE(sc, index, data)        (*(sc)->sc_writereg)(sc, index, data)
 106
 107         void    *parent;
 108
 109         /* We keep track of these */
 110         struct ad1848_volume gains[AD1848_NUM_CHANNELS];
 111         struct ad1848_volume rec_gain;
 112
 113         int     rec_port;               /* recording port */
 114
 115         /* ad1848 */
 116         u_char  MCE_bit;
 117         char    mic_gain_on;            /* CS4231 only */
 118         char    mute[AD1848_NUM_CHANNELS];
 119
 120         const char      *chip_name;
 121         int     mode;
 122         int     is_ad1845;
 123
 124         u_int   precision;              /* 8/16 bits */
 125         int     channels;
 126
 127         u_char  speed_bits;
 128         u_char  format_bits;
 129         u_char  need_commit;
 130
 131         u_char  wave_mute_status;
 132         int     open_mode;
 133 };
 134
 135 /*
 136  * Ad1848 registers.
 137  */
 138 #define MIC_IN_PORT     0
 139 #define LINE_IN_PORT    1
 140 #define AUX1_IN_PORT    2
 141 #define DAC_IN_PORT     3
 142
 143 #define AD1848_KIND_LVL         0
 144 #define AD1848_KIND_MUTE        1
 145 #define AD1848_KIND_RECORDGAIN  2
 146 #define AD1848_KIND_MICGAIN     3
 147 #define AD1848_KIND_RECORDSOURCE 4
 148
 149 typedef struct ad1848_devmap {
 150         int  id;
 151         int  kind;
 152         int  dev;
 153 } ad1848_devmap_t;
 154
 155 #ifdef _KERNEL
 156
 157 int     ad_read(struct ad1848_softc *, int);
 158 int     ad_xread(struct ad1848_softc *, int);
 159 void    ad_write(struct ad1848_softc *, int, int);
 160 void    ad_xwrite(struct ad1848_softc *, int, int);
 161
 162 void    ad1848_attach(struct ad1848_softc *);
 163 void    ad1848_reset(struct ad1848_softc *);
 164 int     ad1848_open(void *, int);
 165 void    ad1848_close(void *);
 166
 167 int     ad1848_mixer_get_port(struct ad1848_softc *, const ad1848_devmap_t *,
 168             int, mixer_ctrl_t *);
 169 int     ad1848_mixer_set_port(struct ad1848_softc *, const ad1848_devmap_t *,
 170             int, mixer_ctrl_t *);
 171 int     ad1848_set_speed(struct ad1848_softc *, u_int *);
 172 void    ad1848_mute_wave_output(struct ad1848_softc *, int, int);
 173 int     ad1848_query_encoding(void *, struct audio_encoding *);
 174 int     ad1848_set_params(void *, int, int, audio_params_t *,
 175             audio_params_t *, stream_filter_list_t *,
 176             stream_filter_list_t *);
 177 int     ad1848_round_blocksize(void *, int, int, const audio_params_t *);
 178 int     ad1848_commit_settings(void *);
 179 int     ad1848_set_rec_port(struct ad1848_softc *, int);
 180 int     ad1848_get_rec_port(struct ad1848_softc *);
 181 int     ad1848_set_channel_gain(struct ad1848_softc *, int,
 182             struct ad1848_volume *);
 183 int     ad1848_get_device_gain(struct ad1848_softc *, int,
 184             struct ad1848_volume *);
 185 int     ad1848_set_rec_gain(struct ad1848_softc *, struct ad1848_volume *);
 186 int     ad1848_get_rec_gain(struct ad1848_softc *, struct ad1848_volume *);
 187 /* Note: The mic pre-MUX gain is not a variable gain, it's 20dB or 0dB */
 188 int     ad1848_set_mic_gain(struct ad1848_softc *, struct ad1848_volume *);
 189 int     ad1848_get_mic_gain(struct ad1848_softc *, struct ad1848_volume *);
 190 void    ad1848_mute_channel(struct ad1848_softc *, int, int);
 191 int     ad1848_to_vol(mixer_ctrl_t *, struct ad1848_volume *);
 192 int     ad1848_from_vol(mixer_ctrl_t *, struct ad1848_volume *);
 193
 194 int     ad1848_halt_output(void *);
 195 int     ad1848_halt_input(void *);
 196 paddr_t ad1848_mappage(void *, void *, off_t, int);
 197
 198 #ifdef AUDIO_DEBUG
 199 void    ad1848_dump_regs(struct ad1848_softc *);
 200 #endif
 201
 202 #endif