Home | History | Annotate | Line # | Download | only in isa
sbdspvar.h revision 1.60
      1 /*	$NetBSD: sbdspvar.h,v 1.60 2009/05/12 09:10:15 cegger Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1991-1993 Regents of the University of California.
      5  * All rights reserved.
      6  *
      7  * Redistribution and use in source and binary forms, with or without
      8  * modification, are permitted provided that the following conditions
      9  * are met:
     10  * 1. Redistributions of source code must retain the above copyright
     11  *    notice, this list of conditions and the following disclaimer.
     12  * 2. Redistributions in binary form must reproduce the above copyright
     13  *    notice, this list of conditions and the following disclaimer in the
     14  *    documentation and/or other materials provided with the distribution.
     15  * 3. All advertising materials mentioning features or use of this software
     16  *    must display the following acknowledgement:
     17  *	This product includes software developed by the Computer Systems
     18  *	Engineering Group at Lawrence Berkeley Laboratory.
     19  * 4. Neither the name of the University nor of the Laboratory may be used
     20  *    to endorse or promote products derived from this software without
     21  *    specific prior written permission.
     22  *
     23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     33  * SUCH DAMAGE.
     34  *
     35  */
     36 
     37 #include "mpu.h"
     38 #if NMPU > 0
     39 #include <dev/ic/mpuvar.h>
     40 #endif
     41 
     42 #define SB_MASTER_VOL	0
     43 #define SB_MIDI_VOL	1
     44 #define SB_CD_VOL	2
     45 #define SB_VOICE_VOL	3
     46 #define SB_OUTPUT_CLASS	4
     47 
     48 #define SB_MIC_VOL	5
     49 #define SB_LINE_IN_VOL	6
     50 #define	SB_RECORD_SOURCE 7
     51 #define SB_TREBLE	8
     52 #define SB_BASS		9
     53 #define SB_RECORD_CLASS	10
     54 #define SB_INPUT_CLASS	11
     55 
     56 #define SB_PCSPEAKER	12
     57 #define SB_INPUT_GAIN	13
     58 #define SB_OUTPUT_GAIN	14
     59 #define SB_AGC		15
     60 #define SB_EQUALIZATION_CLASS 16
     61 
     62 #define SB_CD_IN_MUTE	17
     63 #define SB_MIC_IN_MUTE	18
     64 #define SB_LINE_IN_MUTE	19
     65 #define SB_MIDI_IN_MUTE	20
     66 
     67 #define SB_CD_SWAP	21
     68 #define SB_MIC_SWAP	22
     69 #define SB_LINE_SWAP	23
     70 #define SB_MIDI_SWAP	24
     71 
     72 #define SB_CD_OUT_MUTE	25
     73 #define SB_MIC_OUT_MUTE	26
     74 #define SB_LINE_OUT_MUTE 27
     75 
     76 #define SB_NDEVS	28
     77 
     78 #define SB_IS_IN_MUTE(x) ((x) < SB_CD_SWAP)
     79 
     80 /*
     81  * Software state, per SoundBlaster card.
     82  * The soundblaster has multiple functionality, which we must demultiplex.
     83  * One approach is to have one major device number for the soundblaster card,
     84  * and use different minor numbers to indicate which hardware function
     85  * we want.  This would make for one large driver.  Instead our approach
     86  * is to partition the design into a set of drivers that share an underlying
     87  * piece of hardware.  Most things are hard to share, for example, the audio
     88  * and midi ports.  For audio, we might want to mix two processes' signals,
     89  * and for midi we might want to merge streams (this is hard due to
     90  * running status).  Moreover, we should be able to re-use the high-level
     91  * modules with other kinds of hardware.  In this module, we only handle the
     92  * most basic communications with the sb card.
     93  */
     94 struct sbdsp_softc {
     95 	device_t sc_dev;		/* base device */
     96 	isa_chipset_tag_t sc_ic;
     97 	bus_space_tag_t sc_iot;		/* tag */
     98 	bus_space_handle_t sc_ioh;	/* handle */
     99 	void	*sc_ih;			/* interrupt vectoring */
    100 
    101 	/* XXX These are only for setting chip configuration registers. */
    102 	int	sc_iobase;		/* I/O port base address */
    103 	int	sc_irq;			/* interrupt */
    104 
    105 	int	sc_drq8;		/* DMA (8-bit) */
    106 	bus_size_t sc_drq8_maxsize;
    107 	int	sc_drq16;		/* DMA (16-bit) */
    108 	bus_size_t sc_drq16_maxsize;
    109 
    110 	u_int	sc_quirks;		/* minor variations */
    111 #define SB_QUIRK_NO_INIT_DRQ	0x01
    112 
    113 	int	sc_open;		/* reference count of open calls */
    114 #define SB_CLOSED 0
    115 #define SB_OPEN_AUDIO 1
    116 #define SB_OPEN_MIDI 2
    117 	u_char	sc_fullduplex;		/* can do full duplex */
    118 
    119 	u_char	gain[SB_NDEVS][2];	/* kept in input levels */
    120 #define SB_LEFT 0
    121 #define SB_RIGHT 1
    122 #define SB_LR 0
    123 
    124 	u_int	in_mask;		/* input ports */
    125 	u_int	in_port;		/* XXX needed for MI interface */
    126 	u_int	in_filter;		/* one of SB_TREBLE_EQ, SB_BASS_EQ, 0 */
    127 
    128 	u_int	spkr_state;		/* non-null is on */
    129 
    130 	struct sbdsp_state {
    131 		u_int	rate;		/* Sample rate */
    132 		u_char	tc;		/* Time constant */
    133 		struct	sbmode *modep;
    134 		u_char	bmode;
    135 		int	dmachan;	/* DMA channel */
    136 		int	blksize;	/* Block size, preadjusted */
    137 		u_char	run;
    138 #define SB_NOTRUNNING 0		/* Not running, not initialized */
    139 #define SB_RUNNING 3		/* non-looping mode */
    140 #define SB_LOOPING 2		/* DMA&PCM running (looping mode) */
    141 	} sc_i, sc_o;			/* Input and output state */
    142 
    143 	u_long	sc_interrupts;		/* number of interrupts taken */
    144 
    145 	int	(*sc_intr8)(void*);	/* DMA completion intr handler */
    146 	int	(*sc_intr16)(void*);	/* DMA completion intr handler */
    147 	void	(*sc_intrp)(void*);	/* PCM output intr handler */
    148 	void	*sc_argp;		/* arg for sc_intrp() */
    149 	void	(*sc_intrr)(void*);	/* PCM input intr handler */
    150 	void	*sc_argr;		/* arg for sc_intrr() */
    151 	void	(*sc_intrm)(void*, int);/* midi input intr handler */
    152 	void	*sc_argm;		/* arg for sc_intrm() */
    153 
    154 	u_int	sc_mixer_model;
    155 #define SBM_NONE	0
    156 #define SBM_CT1335	1
    157 #define SBM_CT1345	2
    158 #define SBM_CT1XX5	3
    159 #define SBM_CT1745	4
    160 #define ISSBM1745(x) ((x)->sc_mixer_model >= SBM_CT1XX5)
    161 
    162 	u_int	sc_model;		/* DSP model */
    163 #define SB_UNK	-1
    164 #define SB_1	0			/* original SB */
    165 #define SB_20	1			/* SB 2 */
    166 #define SB_2x	2			/* SB 2, new version */
    167 #define SB_PRO	3			/* SB Pro */
    168 #define SB_JAZZ	4			/* Jazz 16 */
    169 #define SB_16	5			/* SB 16 */
    170 #define SB_32	6			/* SB AWE 32 */
    171 #define SB_64	7			/* SB AWE 64 */
    172 
    173 #define SB_NAMES { "SB_1", "SB_2.0", "SB_2.x", "SB_Pro", "Jazz_16", "SB_16", \
    174 		"SB_AWE_32", "SB_AWE_64" }
    175 
    176 	u_int	sc_version;		/* DSP version */
    177 #define SBVER_MAJOR(v)	(((v)>>8) & 0xff)
    178 #define SBVER_MINOR(v)	((v)&0xff)
    179 
    180 #if NMPU > 0
    181 	int	sc_hasmpu;
    182 #define SBMPU_EXTERNAL	1
    183 #define SBMPU_INTERNAL	0
    184 #define SBMPU_NONE	-1
    185 	device_t sc_mpudev;
    186 	bus_space_tag_t sc_mpu_iot;	/* tag */
    187 	bus_space_handle_t sc_mpu_ioh;	/* handle */
    188 #endif
    189 };
    190 
    191 #define ISSBPRO(sc) ((sc)->sc_model == SB_PRO || (sc)->sc_model == SB_JAZZ)
    192 #define ISSBPROCLASS(sc) ((sc)->sc_model >= SB_PRO)
    193 #define ISSB16CLASS(sc) ((sc)->sc_model >= SB_16)
    194 
    195 #ifdef _KERNEL
    196 struct malloc_type;
    197 
    198 int	sbdsp_open(void *, int);
    199 void	sbdsp_close(void *);
    200 
    201 int	sbdsp_probe(struct sbdsp_softc *, cfdata_t);
    202 void	sbdsp_attach(struct sbdsp_softc *);
    203 
    204 int	sbdsp_set_in_gain(void *, u_int, u_char);
    205 int	sbdsp_set_in_gain_real(void *, u_int, u_char);
    206 int	sbdsp_get_in_gain(void *);
    207 int	sbdsp_set_out_gain(void *, u_int, u_char);
    208 int	sbdsp_set_out_gain_real(void *, u_int, u_char);
    209 int	sbdsp_get_out_gain(void *);
    210 int	sbdsp_set_monitor_gain(void *, u_int);
    211 int	sbdsp_get_monitor_gain(void *);
    212 int	sbdsp_query_encoding(void *, struct audio_encoding *);
    213 int	sbdsp_set_params(void *, int, int, audio_params_t *, audio_params_t *,
    214 	    stream_filter_list_t *, stream_filter_list_t *);
    215 int	sbdsp_round_blocksize(void *, int, int, const audio_params_t *);
    216 int	sbdsp_get_avail_in_ports(void *);
    217 int	sbdsp_get_avail_out_ports(void *);
    218 int	sbdsp_speaker_ctl(void *, int);
    219 
    220 int	sbdsp_commit(void *);
    221 int	sbdsp_trigger_output(void *, void *, void *, int, void (*)(void *),
    222 	    void *, const audio_params_t *);
    223 int	sbdsp_trigger_input(void *, void *, void *, int, void (*)(void *),
    224 	    void *, const audio_params_t *);
    225 int	sbdsp_halt_output(void *);
    226 int	sbdsp_halt_input(void *);
    227 
    228 void	sbdsp_compress(int, u_char *, int);
    229 void	sbdsp_expand(int, u_char *, int);
    230 
    231 int	sbdsp_reset(struct sbdsp_softc *);
    232 void	sbdsp_spkron(struct sbdsp_softc *);
    233 void	sbdsp_spkroff(struct sbdsp_softc *);
    234 
    235 int	sbdsp_wdsp(struct sbdsp_softc *, int);
    236 int	sbdsp_rdsp(struct sbdsp_softc *);
    237 
    238 int	sbdsp_intr(void *);
    239 
    240 int	sbdsp_set_sr(struct sbdsp_softc *, u_long *, int);
    241 
    242 void	sbdsp_mix_write(struct sbdsp_softc *, int, int);
    243 int	sbdsp_mix_read(struct sbdsp_softc *, int);
    244 
    245 int	sbdsp_mixer_set_port(void *, mixer_ctrl_t *);
    246 int	sbdsp_mixer_get_port(void *, mixer_ctrl_t *);
    247 int	sbdsp_mixer_query_devinfo(void *, mixer_devinfo_t *);
    248 
    249 void	*sb_malloc(void *, int, size_t, struct malloc_type *, int);
    250 void	sb_free(void *, void *, struct malloc_type *);
    251 size_t	sb_round_buffersize(void *, int, size_t);
    252 paddr_t	sb_mappage(void *, void *, off_t, int);
    253 
    254 int	sbdsp_get_props(void *);
    255 
    256 
    257 int	sbdsp_midi_open(void *, int, void (*iintr)(void *, int),
    258 	    void (*ointr)(void *), void *);
    259 void	sbdsp_midi_close(void *);
    260 int	sbdsp_midi_output(void *, int);
    261 void	sbdsp_midi_getinfo(void *, struct midi_info *);
    262 #endif
    263