xref: /freebsd/sys/dev/sound/pci/emu10kx.h (revision 8ce574de3b680e0a08b4c58c2a949f26963828af)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 1999 Cameron Grant <gandalf@vilnya.demon.co.uk>
5  * Copyright (c) 2003-2006 Yuriy Tsibizov <yuriy.tsibizov@gfk.ru>
6  * All rights reserved.
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 THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHERIN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  * $FreeBSD$
30  */
31 
32 #ifndef EMU10KX_H
33 #define	EMU10KX_H
34 
35 #define	SND_EMU10KX_MINVER	1
36 #define	SND_EMU10KX_PREFVER	1
37 #define	SND_EMU10KX_MAXVER	1
38 
39 #ifdef _KERNEL
40 
41 #define	EMUPAGESIZE	4096
42 #define	NUM_G		64
43 /* XXX some (empty) samples are played when play buffer is > EMUPAGESIZE */
44 #define	EMU_PLAY_BUFSZ	EMUPAGESIZE
45 /* Recording is limited by EMUPAGESIZE*16=64K buffer */
46 #define	EMU_REC_BUFSZ	EMUPAGESIZE*16
47 #define	EMU_MAX_BUFSZ	EMUPAGESIZE*16
48 #define	EMU_MAXPAGES	8192
49 
50 
51 #define	EMU_VAR_FUNC		0
52 #define	EMU_VAR_ROUTE		1
53 #define	EMU_VAR_ISEMU10K1 	2
54 #define	EMU_VAR_MCH_DISABLED 	3
55 #define	EMU_VAR_MCH_REC 	4
56 
57 #define EMU_A_IOCFG_DISABLE_ANALOG	0x0040	/* = 'enable' for Audigy2 */
58 #define EMU_A_IOCFG_GPOUT2	0x0001
59 #define EMU_AC97SLOT_REAR_RIGHT	0x01
60 #define EMU_AC97SLOT_REAR_LEFT	0x02
61 #define EMU_HCFG_GPOUT0		0x00001000
62 #define EMU_HCFG_GPOUT1		0x00000800
63 #define EMU_HCFG_GPOUT2		0x00000400
64 
65 #define	RT_FRONT		0
66 #define	RT_REAR			1
67 #define	RT_CENTER		2
68 #define	RT_SUB			3
69 #define	RT_SIDE			4
70 #define	RT_MCHRECORD		5
71 #define	RT_COUNT		6
72 
73 /* mixer controls */
74 /* fx play */
75 #define	M_FX0_FRONT_L		0
76 #define	M_FX1_FRONT_R		1
77 #define	M_FX2_REAR_L		2
78 #define	M_FX3_REAR_R		3
79 #define	M_FX4_CENTER		4
80 #define	M_FX5_SUBWOOFER		5
81 #define	M_FX6_SIDE_L		6
82 #define	M_FX7_SIDE_R		7
83 /* fx rec */
84 #define	M_FX0_REC_L		8
85 #define	M_FX1_REC_R		9
86 /* inputs play */
87 #define	M_IN0_FRONT_L		10
88 #define	M_IN0_FRONT_R		11
89 #define	M_IN1_FRONT_L		12
90 #define	M_IN1_FRONT_R		13
91 #define	M_IN2_FRONT_L		14
92 #define	M_IN2_FRONT_R		15
93 #define	M_IN3_FRONT_L		16
94 #define	M_IN3_FRONT_R		17
95 #define	M_IN4_FRONT_L		18
96 #define	M_IN4_FRONT_R		19
97 #define	M_IN5_FRONT_L		20
98 #define	M_IN5_FRONT_R		21
99 #define	M_IN6_FRONT_L		22
100 #define	M_IN6_FRONT_R		23
101 #define	M_IN7_FRONT_L		24
102 #define	M_IN7_FRONT_R		25
103 /* inputs rec */
104 #define	M_IN0_REC_L		26
105 #define	M_IN0_REC_R		27
106 #define	M_IN1_REC_L		28
107 #define	M_IN1_REC_R		29
108 #define	M_IN2_REC_L		30
109 #define	M_IN2_REC_R		31
110 #define	M_IN3_REC_L		32
111 #define	M_IN3_REC_R		33
112 #define	M_IN4_REC_L		34
113 #define	M_IN4_REC_R		35
114 #define	M_IN5_REC_L		36
115 #define	M_IN5_REC_R		37
116 #define	M_IN6_REC_L		38
117 #define	M_IN6_REC_R		39
118 #define	M_IN7_REC_L		40
119 #define	M_IN7_REC_R		41
120 /* master volume */
121 #define	M_MASTER_FRONT_L	42
122 #define	M_MASTER_FRONT_R	43
123 #define	M_MASTER_REAR_L		44
124 #define	M_MASTER_REAR_R		45
125 #define	M_MASTER_CENTER		46
126 #define	M_MASTER_SUBWOOFER	47
127 #define	M_MASTER_SIDE_L		48
128 #define	M_MASTER_SIDE_R		49
129 /* master rec volume */
130 #define	M_MASTER_REC_L		50
131 #define	M_MASTER_REC_R		51
132 
133 #define	NUM_MIXERS		52
134 
135 struct emu_sc_info;
136 
137 /* MIDI device parameters */
138 struct emu_midiinfo {
139 	struct emu_sc_info *card;
140 	int		port;
141 	int		portnr;
142 };
143 
144 /* PCM device parameters */
145 struct emu_pcminfo {
146 	struct emu_sc_info *card;
147 	int		route;
148 };
149 
150 int	emu_intr_register(struct emu_sc_info *sc, uint32_t inte_mask, uint32_t intr_mask, uint32_t(*func) (void *softc, uint32_t irq), void *isc);
151 int	emu_intr_unregister(struct emu_sc_info *sc, int ihandle);
152 
153 uint32_t emu_rd(struct emu_sc_info *sc, unsigned int regno, unsigned int size);
154 void	emu_wr(struct emu_sc_info *sc, unsigned int regno, uint32_t data, unsigned int size);
155 
156 uint32_t emu_rdptr(struct emu_sc_info *sc, unsigned int chn, unsigned int reg);
157 void	emu_wrptr(struct emu_sc_info *sc, unsigned int chn, unsigned int reg, uint32_t data);
158 
159 uint32_t emu_rd_p16vptr(struct emu_sc_info *sc, uint16_t chn, uint16_t reg);
160 void	emu_wr_p16vptr(struct emu_sc_info *sc, uint16_t chn, uint16_t reg, uint32_t data);
161 
162 int	emu_timer_create(struct emu_sc_info *sc);
163 int	emu_timer_set(struct emu_sc_info *sc, int timer, int delay);
164 int	emu_timer_enable(struct emu_sc_info *sc, int timer, int go);
165 int	emu_timer_clear(struct emu_sc_info *sc, int timer);
166 
167 struct emu_voice;
168 
169 struct emu_route {
170 	int	routing_left[8];
171 	int	amounts_left[8];
172 	int	routing_right[8];
173 	int	amounts_right[8];
174 };
175 
176 struct emu_voice* emu_valloc(struct emu_sc_info *sc);
177 void 	emu_vfree(struct emu_sc_info *sc, struct emu_voice *v);
178 int	emu_vinit(struct emu_sc_info *sc, struct emu_voice *m, struct emu_voice *s,
179     uint32_t sz, struct snd_dbuf *b);
180 void	emu_vroute(struct emu_sc_info *sc, struct emu_route *rt,  struct emu_voice *v);
181 void	emu_vsetup(struct emu_voice *v, int fmt, int spd);
182 void	emu_vwrite(struct emu_sc_info *sc, struct emu_voice *v);
183 void	emu_vtrigger(struct emu_sc_info *sc, struct emu_voice *v, int go);
184 int	emu_vpos(struct emu_sc_info *sc, struct emu_voice *v);
185 
186 bus_dma_tag_t emu_gettag(struct emu_sc_info *sc);
187 
188 void	emumix_set_volume(struct emu_sc_info *sc, int mixer_idx, int volume);
189 int	emumix_get_volume(struct emu_sc_info *sc, int mixer_idx);
190 
191 void	emu_enable_ir(struct emu_sc_info *sc);
192 #endif				/* _KERNEL */
193 #endif				/* EMU10K1_H */
194