xref: /linux/sound/pci/au88x0/au88x0.h (revision 2ee692802b8f6c54bd6499addd3d07c2833d84d8)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  */
4 
5 #ifndef __SOUND_AU88X0_H
6 #define __SOUND_AU88X0_H
7 
8 #include <linux/pci.h>
9 #include <linux/io.h>
10 #include <sound/core.h>
11 #include <sound/pcm.h>
12 #include <sound/rawmidi.h>
13 #include <sound/mpu401.h>
14 #include <sound/hwdep.h>
15 #include <sound/ac97_codec.h>
16 #include <sound/tlv.h>
17 
18 #ifndef CHIP_AU8820
19 #include "au88x0_eq.h"
20 #include "au88x0_a3d.h"
21 #endif
22 #ifndef CHIP_AU8810
23 #include "au88x0_wt.h"
24 #endif
25 
26 #define	hwread(x,y) readl((x)+(y))
27 #define	hwwrite(x,y,z) writel((z),(x)+(y))
28 
29 /* Vortex MPU401 defines. */
30 #define	MIDI_CLOCK_DIV		0x61
31 /* Standart MPU401 defines. */
32 #define	MPU401_RESET		0xff
33 #define	MPU401_ENTER_UART	0x3f
34 #define	MPU401_ACK		0xfe
35 
36 // Get src register value to convert from x to y.
37 #define	SRC_RATIO(x,y)		((((x<<15)/y) + 1)/2)
38 
39 /* FIFO software state constants. */
40 #define FIFO_STOP 0
41 #define FIFO_START 1
42 #define FIFO_PAUSE 2
43 
44 /* IRQ flags */
45 #define IRQ_ERR_MASK	0x00ff
46 #define IRQ_FATAL	0x0001
47 #define IRQ_PARITY	0x0002
48 #define IRQ_REG		0x0004
49 #define IRQ_FIFO	0x0008
50 #define IRQ_DMA		0x0010
51 #define IRQ_PCMOUT	0x0020	/* PCM OUT page crossing */
52 #define IRQ_TIMER	0x1000
53 #define IRQ_MIDI	0x2000
54 #define IRQ_MODEM	0x4000
55 
56 /* ADB Resource */
57 #define VORTEX_RESOURCE_DMA	0x00000000
58 #define VORTEX_RESOURCE_SRC	0x00000001
59 #define VORTEX_RESOURCE_MIXIN	0x00000002
60 #define VORTEX_RESOURCE_MIXOUT	0x00000003
61 #define VORTEX_RESOURCE_A3D	0x00000004
62 #define VORTEX_RESOURCE_LAST	0x00000005
63 
64 /* codec io: VORTEX_CODEC_IO bits */
65 #define VORTEX_CODEC_ID_SHIFT	24
66 #define VORTEX_CODEC_WRITE	0x00800000
67 #define VORTEX_CODEC_ADDSHIFT 	16
68 #define VORTEX_CODEC_ADDMASK	0x7f0000
69 #define VORTEX_CODEC_DATSHIFT	0
70 #define VORTEX_CODEC_DATMASK	0xffff
71 
72 /* Check for SDAC bit in "Extended audio ID" AC97 register */
73 //#define VORTEX_IS_QUAD(x) (((x)->codec == NULL) ?  0 : ((x)->codec->ext_id&0x80))
74 #define VORTEX_IS_QUAD(x) ((x)->isquad)
75 /* Check if chip has bug. */
76 #define IS_BAD_CHIP(x) (\
77 	(x->rev == 0xfe && x->device == PCI_DEVICE_ID_AUREAL_VORTEX_2) || \
78 	(x->rev == 0xfe && x->device == PCI_DEVICE_ID_AUREAL_ADVANTAGE))
79 
80 
81 /* PCM devices */
82 #define VORTEX_PCM_ADB		0
83 #define VORTEX_PCM_SPDIF	1
84 #define VORTEX_PCM_A3D		2
85 #define VORTEX_PCM_WT		3
86 #define VORTEX_PCM_I2S		4
87 #define VORTEX_PCM_LAST		5
88 
89 #define MIX_CAPT(x) (vortex->mixcapt[x])
90 #define MIX_PLAYB(x) (vortex->mixplayb[x])
91 #define MIX_SPDIF(x) (vortex->mixspdif[x])
92 
93 #define NR_WTPB 0x20		/* WT channels per each bank. */
94 #define NR_PCM	0x10
95 
96 struct pcm_vol {
97 	struct snd_kcontrol *kctl;
98 	int active;
99 	int dma;
100 	int mixin[4];
101 	int vol[4];
102 };
103 
104 /* Structs */
105 typedef struct {
106 	//int this_08;          /* Still unknown */
107 	int fifo_enabled;	/* this_24 */
108 	int fifo_status;	/* this_1c */
109 	u32 dma_ctrl;		/* this_78 (ADB), this_7c (WT) */
110 	int dma_unknown;	/* this_74 (ADB), this_78 (WT). WDM: +8 */
111 	int cfg0;
112 	int cfg1;
113 
114 	int nr_ch;		/* Nr of PCM channels in use */
115 	int type;		/* Output type (ac97, a3d, spdif, i2s, dsp) */
116 	int dma;		/* Hardware DMA index. */
117 	int dir;		/* Stream Direction. */
118 	u32 resources[5];
119 
120 	/* Virtual page extender stuff */
121 	int nr_periods;
122 	int period_bytes;
123 	int period_real;
124 	int period_virt;
125 
126 	struct snd_pcm_substream *substream;
127 } stream_t;
128 
129 typedef struct snd_vortex vortex_t;
130 struct snd_vortex {
131 	/* ALSA structs. */
132 	struct snd_card *card;
133 	struct snd_pcm *pcm[VORTEX_PCM_LAST];
134 
135 	struct snd_rawmidi *rmidi;	/* Legacy Midi interface. */
136 	struct snd_ac97 *codec;
137 
138 	/* Stream structs. */
139 	stream_t dma_adb[NR_ADB];
140 	int spdif_sr;
141 #ifndef CHIP_AU8810
142 	stream_t dma_wt[NR_WT];
143 	wt_voice_t wt_voice[NR_WT];	/* WT register cache. */
144 	char mixwt[(NR_WT / NR_WTPB) * 6];	/* WT mixin objects */
145 #endif
146 
147 	/* Global resources */
148 	s8 mixcapt[2];
149 	s8 mixplayb[4];
150 #ifndef CHIP_AU8820
151 	s8 mixspdif[2];
152 	s8 mixa3d[2];	/* mixers which collect all a3d streams. */
153 	s8 mixxtlk[2];	/* crosstalk canceler mixer inputs. */
154 #endif
155 	u32 fixed_res[5];
156 
157 #ifndef CHIP_AU8820
158 	/* Hardware equalizer structs */
159 	eqlzr_t eq;
160 	/* A3D structs */
161 	a3dsrc_t a3d[NR_A3D];
162 	/* Xtalk canceler */
163 	int xt_mode;		/* 1: speakers, 0:headphones. */
164 #endif
165 	struct pcm_vol pcm_vol[NR_PCM];
166 
167 	int isquad;		/* cache of extended ID codec flag. */
168 
169 	/* Gameport stuff. */
170 	struct gameport *gameport;
171 
172 	/* PCI hardware resources */
173 	unsigned long io;
174 	void __iomem *mmio;
175 	unsigned int irq;
176 	spinlock_t lock;
177 
178 	/* PCI device */
179 	struct pci_dev *pci_dev;
180 	u16 vendor;
181 	u16 device;
182 	u8 rev;
183 };
184 
185 /* Functions. */
186 
187 /* SRC */
188 static void vortex_adb_setsrc(vortex_t * vortex, int adbdma,
189 			      unsigned int cvrt, int dir);
190 
191 /* DMA Engines. */
192 static void vortex_adbdma_setbuffers(vortex_t * vortex, int adbdma,
193 				     int size, int count);
194 static void vortex_adbdma_setmode(vortex_t * vortex, int adbdma, int ie,
195 				  int dir, int fmt, int d,
196 				  u32 offset);
197 static void vortex_adbdma_setstartbuffer(vortex_t * vortex, int adbdma, int sb);
198 #ifndef CHIP_AU8810
199 static void vortex_wtdma_setbuffers(vortex_t * vortex, int wtdma,
200 				    int size, int count);
201 static void vortex_wtdma_setmode(vortex_t * vortex, int wtdma, int ie, int fmt, int d,	/*int e, */
202 				 u32 offset);
203 static void vortex_wtdma_setstartbuffer(vortex_t * vortex, int wtdma, int sb);
204 #endif
205 
206 static void vortex_adbdma_startfifo(vortex_t * vortex, int adbdma);
207 //static void vortex_adbdma_stopfifo(vortex_t *vortex, int adbdma);
208 static void vortex_adbdma_pausefifo(vortex_t * vortex, int adbdma);
209 static void vortex_adbdma_resumefifo(vortex_t * vortex, int adbdma);
210 static inline int vortex_adbdma_getlinearpos(vortex_t * vortex, int adbdma);
211 static void vortex_adbdma_resetup(vortex_t *vortex, int adbdma);
212 
213 #ifndef CHIP_AU8810
214 static void vortex_wtdma_startfifo(vortex_t * vortex, int wtdma);
215 static void vortex_wtdma_stopfifo(vortex_t * vortex, int wtdma);
216 static void vortex_wtdma_pausefifo(vortex_t * vortex, int wtdma);
217 static void vortex_wtdma_resumefifo(vortex_t * vortex, int wtdma);
218 static inline int vortex_wtdma_getlinearpos(vortex_t * vortex, int wtdma);
219 #endif
220 
221 /* global stuff. */
222 static void vortex_codec_init(vortex_t * vortex);
223 static void vortex_codec_write(struct snd_ac97 * codec, unsigned short addr,
224 			       unsigned short data);
225 static unsigned short vortex_codec_read(struct snd_ac97 * codec, unsigned short addr);
226 static void vortex_spdif_init(vortex_t * vortex, int spdif_sr, int spdif_mode);
227 
228 static int vortex_core_init(vortex_t * card);
229 static int vortex_core_shutdown(vortex_t * card);
230 static void vortex_enable_int(vortex_t * card);
231 static irqreturn_t vortex_interrupt(int irq, void *dev_id);
232 static int vortex_alsafmt_aspfmt(snd_pcm_format_t alsafmt, vortex_t *v);
233 
234 /* Connection  stuff. */
235 static void vortex_connect_default(vortex_t * vortex, int en);
236 static int vortex_adb_allocroute(vortex_t * vortex, int dma, int nr_ch,
237 				 int dir, int type, int subdev);
238 static char vortex_adb_checkinout(vortex_t * vortex, int resmap[], int out,
239 				  int restype);
240 #ifndef CHIP_AU8810
241 static int vortex_wt_allocroute(vortex_t * vortex, int dma, int nr_ch);
242 static void vortex_wt_connect(vortex_t * vortex, int en);
243 static void vortex_wt_init(vortex_t * vortex);
244 #endif
245 
246 static void vortex_route(vortex_t * vortex, int en, unsigned char channel,
247 			 unsigned char source, unsigned char dest);
248 #if 0
249 static void vortex_routes(vortex_t * vortex, int en, unsigned char channel,
250 			  unsigned char source, unsigned char dest0,
251 			  unsigned char dest1);
252 #endif
253 static void vortex_connection_mixin_mix(vortex_t * vortex, int en,
254 					unsigned char mixin,
255 					unsigned char mix, int a);
256 static void vortex_mix_setinputvolumebyte(vortex_t * vortex,
257 					  unsigned char mix, int mixin,
258 					  unsigned char vol);
259 static void vortex_mix_setvolumebyte(vortex_t * vortex, unsigned char mix,
260 				     unsigned char vol);
261 
262 /* A3D functions. */
263 #ifndef CHIP_AU8820
264 static void vortex_Vort3D_enable(vortex_t * v);
265 static void vortex_Vort3D_disable(vortex_t * v);
266 static void vortex_Vort3D_connect(vortex_t * vortex, int en);
267 static void vortex_Vort3D_InitializeSource(a3dsrc_t *a, int en, vortex_t *v);
268 #endif
269 
270 /* Driver stuff. */
271 static int vortex_gameport_register(vortex_t * card);
272 static void vortex_gameport_unregister(vortex_t * card);
273 #ifndef CHIP_AU8820
274 static int vortex_eq_init(vortex_t * vortex);
275 static int vortex_eq_free(vortex_t * vortex);
276 #endif
277 /* ALSA stuff. */
278 static int snd_vortex_new_pcm(vortex_t * vortex, int idx, int nr);
279 static int snd_vortex_mixer(vortex_t * vortex);
280 static int snd_vortex_midi(vortex_t * vortex);
281 #endif
282