xref: /linux/include/sound/gus.h (revision 95db3b255fde4e830e5f8cc011eb404023f669d4)
1 #ifndef __SOUND_GUS_H
2 #define __SOUND_GUS_H
3 
4 /*
5  *  Global structures used for GUS part of ALSA driver
6  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
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 #include <sound/pcm.h>
26 #include <sound/rawmidi.h>
27 #include <sound/timer.h>
28 #include <sound/seq_midi_emul.h>
29 #include <sound/seq_device.h>
30 #include <linux/io.h>
31 
32 /* IO ports */
33 
34 #define GUSP(gus, x)			((gus)->gf1.port + SNDRV_g_u_s_##x)
35 
36 #define SNDRV_g_u_s_MIDICTRL		(0x320-0x220)
37 #define SNDRV_g_u_s_MIDISTAT		(0x320-0x220)
38 #define SNDRV_g_u_s_MIDIDATA		(0x321-0x220)
39 
40 #define SNDRV_g_u_s_GF1PAGE		(0x322-0x220)
41 #define SNDRV_g_u_s_GF1REGSEL		(0x323-0x220)
42 #define SNDRV_g_u_s_GF1DATALOW		(0x324-0x220)
43 #define SNDRV_g_u_s_GF1DATAHIGH		(0x325-0x220)
44 #define SNDRV_g_u_s_IRQSTAT		(0x226-0x220)
45 #define SNDRV_g_u_s_TIMERCNTRL		(0x228-0x220)
46 #define SNDRV_g_u_s_TIMERDATA		(0x229-0x220)
47 #define SNDRV_g_u_s_DRAM		(0x327-0x220)
48 #define SNDRV_g_u_s_MIXCNTRLREG		(0x220-0x220)
49 #define SNDRV_g_u_s_IRQDMACNTRLREG	(0x22b-0x220)
50 #define SNDRV_g_u_s_REGCNTRLS		(0x22f-0x220)
51 #define SNDRV_g_u_s_BOARDVERSION	(0x726-0x220)
52 #define SNDRV_g_u_s_MIXCNTRLPORT	(0x726-0x220)
53 #define SNDRV_g_u_s_IVER		(0x325-0x220)
54 #define SNDRV_g_u_s_MIXDATAPORT		(0x326-0x220)
55 #define SNDRV_g_u_s_MAXCNTRLPORT	(0x326-0x220)
56 
57 /* GF1 registers */
58 
59 /* global registers */
60 #define SNDRV_GF1_GB_ACTIVE_VOICES		0x0e
61 #define SNDRV_GF1_GB_VOICES_IRQ			0x0f
62 #define SNDRV_GF1_GB_GLOBAL_MODE		0x19
63 #define SNDRV_GF1_GW_LFO_BASE			0x1a
64 #define SNDRV_GF1_GB_VOICES_IRQ_READ		0x1f
65 #define SNDRV_GF1_GB_DRAM_DMA_CONTROL		0x41
66 #define SNDRV_GF1_GW_DRAM_DMA_LOW		0x42
67 #define SNDRV_GF1_GW_DRAM_IO_LOW		0x43
68 #define SNDRV_GF1_GB_DRAM_IO_HIGH		0x44
69 #define SNDRV_GF1_GB_SOUND_BLASTER_CONTROL	0x45
70 #define SNDRV_GF1_GB_ADLIB_TIMER_1		0x46
71 #define SNDRV_GF1_GB_ADLIB_TIMER_2		0x47
72 #define SNDRV_GF1_GB_RECORD_RATE		0x48
73 #define SNDRV_GF1_GB_REC_DMA_CONTROL		0x49
74 #define SNDRV_GF1_GB_JOYSTICK_DAC_LEVEL		0x4b
75 #define SNDRV_GF1_GB_RESET			0x4c
76 #define SNDRV_GF1_GB_DRAM_DMA_HIGH		0x50
77 #define SNDRV_GF1_GW_DRAM_IO16			0x51
78 #define SNDRV_GF1_GW_MEMORY_CONFIG		0x52
79 #define SNDRV_GF1_GB_MEMORY_CONTROL		0x53
80 #define SNDRV_GF1_GW_FIFO_RECORD_BASE_ADDR	0x54
81 #define SNDRV_GF1_GW_FIFO_PLAY_BASE_ADDR	0x55
82 #define SNDRV_GF1_GW_FIFO_SIZE			0x56
83 #define SNDRV_GF1_GW_INTERLEAVE			0x57
84 #define SNDRV_GF1_GB_COMPATIBILITY		0x59
85 #define SNDRV_GF1_GB_DECODE_CONTROL		0x5a
86 #define SNDRV_GF1_GB_VERSION_NUMBER		0x5b
87 #define SNDRV_GF1_GB_MPU401_CONTROL_A		0x5c
88 #define SNDRV_GF1_GB_MPU401_CONTROL_B		0x5d
89 #define SNDRV_GF1_GB_EMULATION_IRQ		0x60
90 /* voice specific registers */
91 #define SNDRV_GF1_VB_ADDRESS_CONTROL		0x00
92 #define SNDRV_GF1_VW_FREQUENCY			0x01
93 #define SNDRV_GF1_VW_START_HIGH			0x02
94 #define SNDRV_GF1_VW_START_LOW			0x03
95 #define SNDRV_GF1_VA_START			SNDRV_GF1_VW_START_HIGH
96 #define SNDRV_GF1_VW_END_HIGH			0x04
97 #define SNDRV_GF1_VW_END_LOW			0x05
98 #define SNDRV_GF1_VA_END			SNDRV_GF1_VW_END_HIGH
99 #define SNDRV_GF1_VB_VOLUME_RATE		0x06
100 #define SNDRV_GF1_VB_VOLUME_START		0x07
101 #define SNDRV_GF1_VB_VOLUME_END			0x08
102 #define SNDRV_GF1_VW_VOLUME			0x09
103 #define SNDRV_GF1_VW_CURRENT_HIGH		0x0a
104 #define SNDRV_GF1_VW_CURRENT_LOW		0x0b
105 #define SNDRV_GF1_VA_CURRENT			SNDRV_GF1_VW_CURRENT_HIGH
106 #define SNDRV_GF1_VB_PAN			0x0c
107 #define SNDRV_GF1_VW_OFFSET_RIGHT		0x0c
108 #define SNDRV_GF1_VB_VOLUME_CONTROL		0x0d
109 #define SNDRV_GF1_VB_UPPER_ADDRESS		0x10
110 #define SNDRV_GF1_VW_EFFECT_HIGH		0x11
111 #define SNDRV_GF1_VW_EFFECT_LOW			0x12
112 #define SNDRV_GF1_VA_EFFECT			SNDRV_GF1_VW_EFFECT_HIGH
113 #define SNDRV_GF1_VW_OFFSET_LEFT		0x13
114 #define SNDRV_GF1_VB_ACCUMULATOR		0x14
115 #define SNDRV_GF1_VB_MODE			0x15
116 #define SNDRV_GF1_VW_EFFECT_VOLUME		0x16
117 #define SNDRV_GF1_VB_FREQUENCY_LFO		0x17
118 #define SNDRV_GF1_VB_VOLUME_LFO			0x18
119 #define SNDRV_GF1_VW_OFFSET_RIGHT_FINAL		0x1b
120 #define SNDRV_GF1_VW_OFFSET_LEFT_FINAL		0x1c
121 #define SNDRV_GF1_VW_EFFECT_VOLUME_FINAL	0x1d
122 
123 /* ICS registers */
124 
125 #define SNDRV_ICS_MIC_DEV		0
126 #define SNDRV_ICS_LINE_DEV		1
127 #define SNDRV_ICS_CD_DEV		2
128 #define SNDRV_ICS_GF1_DEV		3
129 #define SNDRV_ICS_NONE_DEV		4
130 #define SNDRV_ICS_MASTER_DEV		5
131 
132 /* LFO */
133 
134 #define SNDRV_LFO_TREMOLO		0
135 #define SNDRV_LFO_VIBRATO		1
136 
137 /* misc */
138 
139 #define SNDRV_GF1_DMA_UNSIGNED	0x80
140 #define SNDRV_GF1_DMA_16BIT	0x40
141 #define SNDRV_GF1_DMA_IRQ	0x20
142 #define SNDRV_GF1_DMA_WIDTH16	0x04
143 #define SNDRV_GF1_DMA_READ	0x02	/* read from GUS's DRAM */
144 #define SNDRV_GF1_DMA_ENABLE	0x01
145 
146 /* ramp ranges */
147 
148 #define SNDRV_GF1_ATTEN(x)	(snd_gf1_atten_table[x])
149 #define SNDRV_GF1_MIN_VOLUME	1800
150 #define SNDRV_GF1_MAX_VOLUME	4095
151 #define SNDRV_GF1_MIN_OFFSET	(SNDRV_GF1_MIN_VOLUME>>4)
152 #define SNDRV_GF1_MAX_OFFSET	255
153 #define SNDRV_GF1_MAX_TDEPTH	90
154 
155 /* defines for memory manager */
156 
157 #define SNDRV_GF1_MEM_BLOCK_16BIT	0x0001
158 
159 #define SNDRV_GF1_MEM_OWNER_DRIVER	0x0001
160 #define SNDRV_GF1_MEM_OWNER_WAVE_SIMPLE	0x0002
161 #define SNDRV_GF1_MEM_OWNER_WAVE_GF1	0x0003
162 #define SNDRV_GF1_MEM_OWNER_WAVE_IWFFFF	0x0004
163 
164 /* constants for interrupt handlers */
165 
166 #define SNDRV_GF1_HANDLER_MIDI_OUT	0x00010000
167 #define SNDRV_GF1_HANDLER_MIDI_IN	0x00020000
168 #define SNDRV_GF1_HANDLER_TIMER1	0x00040000
169 #define SNDRV_GF1_HANDLER_TIMER2	0x00080000
170 #define SNDRV_GF1_HANDLER_VOICE		0x00100000
171 #define SNDRV_GF1_HANDLER_DMA_WRITE	0x00200000
172 #define SNDRV_GF1_HANDLER_DMA_READ	0x00400000
173 #define SNDRV_GF1_HANDLER_ALL		(0xffff0000&~SNDRV_GF1_HANDLER_VOICE)
174 
175 /* constants for DMA flags */
176 
177 #define SNDRV_GF1_DMA_TRIGGER		1
178 
179 /* --- */
180 
181 struct snd_gus_card;
182 
183 /* GF1 specific structure */
184 
185 struct snd_gf1_bank_info {
186 	unsigned int address;
187 	unsigned int size;
188 };
189 
190 struct snd_gf1_mem_block {
191 	unsigned short flags;	/* flags - SNDRV_GF1_MEM_BLOCK_XXXX */
192 	unsigned short owner;	/* owner - SNDRV_GF1_MEM_OWNER_XXXX */
193 	unsigned int share;	/* share count */
194 	unsigned int share_id[4]; /* share ID */
195 	unsigned int ptr;
196 	unsigned int size;
197 	char *name;
198 	struct snd_gf1_mem_block *next;
199 	struct snd_gf1_mem_block *prev;
200 };
201 
202 struct snd_gf1_mem {
203 	struct snd_gf1_bank_info banks_8[4];
204 	struct snd_gf1_bank_info banks_16[4];
205 	struct snd_gf1_mem_block *first;
206 	struct snd_gf1_mem_block *last;
207 	struct mutex memory_mutex;
208 };
209 
210 struct snd_gf1_dma_block {
211 	void *buffer;		/* buffer in computer's RAM */
212 	unsigned long buf_addr;	/* buffer address */
213 	unsigned int addr;	/* address in onboard memory */
214 	unsigned int count;	/* count in bytes */
215 	unsigned int cmd;	/* DMA command (format) */
216 	void (*ack)(struct snd_gus_card * gus, void *private_data);
217 	void *private_data;
218 	struct snd_gf1_dma_block *next;
219 };
220 
221 struct snd_gus_port {
222 	struct snd_midi_channel_set * chset;
223 	struct snd_gus_card * gus;
224 	int mode;		/* operation mode */
225 	int client;		/* sequencer client number */
226 	int port;		/* sequencer port number */
227 	unsigned int midi_has_voices: 1;
228 };
229 
230 struct snd_gus_voice;
231 
232 #define SNDRV_GF1_VOICE_TYPE_PCM	0
233 #define SNDRV_GF1_VOICE_TYPE_SYNTH 	1
234 #define SNDRV_GF1_VOICE_TYPE_MIDI	2
235 
236 #define SNDRV_GF1_VFLG_RUNNING		(1<<0)
237 #define SNDRV_GF1_VFLG_EFFECT_TIMER1	(1<<1)
238 #define SNDRV_GF1_VFLG_PAN		(1<<2)
239 
240 enum snd_gus_volume_state {
241 	VENV_BEFORE,
242 	VENV_ATTACK,
243 	VENV_SUSTAIN,
244 	VENV_RELEASE,
245 	VENV_DONE,
246 	VENV_VOLUME
247 };
248 
249 struct snd_gus_voice {
250 	int number;
251 	unsigned int use: 1,
252 	    pcm: 1,
253 	    synth:1,
254 	    midi: 1;
255 	unsigned int flags;
256 	unsigned char client;
257 	unsigned char port;
258 	unsigned char index;
259 	unsigned char pad;
260 
261 #ifdef CONFIG_SND_DEBUG
262 	unsigned int interrupt_stat_wave;
263 	unsigned int interrupt_stat_volume;
264 #endif
265 	void (*handler_wave) (struct snd_gus_card * gus, struct snd_gus_voice * voice);
266 	void (*handler_volume) (struct snd_gus_card * gus, struct snd_gus_voice * voice);
267 	void (*handler_effect) (struct snd_gus_card * gus, struct snd_gus_voice * voice);
268 	void (*volume_change) (struct snd_gus_card * gus);
269 
270 	struct snd_gus_sample_ops *sample_ops;
271 
272 	/* running status / registers */
273 
274 	unsigned short fc_register;
275 	unsigned short fc_lfo;
276 	unsigned short gf1_volume;
277 	unsigned char control;
278 	unsigned char mode;
279 	unsigned char gf1_pan;
280 	unsigned char effect_accumulator;
281 	unsigned char volume_control;
282 	unsigned char venv_value_next;
283 	enum snd_gus_volume_state venv_state;
284 	enum snd_gus_volume_state venv_state_prev;
285 	unsigned short vlo;
286 	unsigned short vro;
287 	unsigned short gf1_effect_volume;
288 
289 	/* --- */
290 
291 	void *private_data;
292 	void (*private_free)(struct snd_gus_voice *voice);
293 };
294 
295 struct snd_gf1 {
296 
297 	unsigned int enh_mode:1,	/* enhanced mode (GFA1) */
298 		     hw_lfo:1,		/* use hardware LFO */
299 		     sw_lfo:1,		/* use software LFO */
300 		     effect:1;		/* use effect voices */
301 
302 	unsigned long port;		/* port of GF1 chip */
303 	struct resource *res_port1;
304 	struct resource *res_port2;
305 	int irq;			/* IRQ number */
306 	int dma1;			/* DMA1 number */
307 	int dma2;			/* DMA2 number */
308 	unsigned int memory;		/* GUS's DRAM size in bytes */
309 	unsigned int rom_memory;	/* GUS's ROM size in bytes */
310 	unsigned int rom_present;	/* bitmask */
311 	unsigned int rom_banks;		/* GUS's ROM banks */
312 
313 	struct snd_gf1_mem mem_alloc;
314 
315 	/* registers */
316 	unsigned short reg_page;
317 	unsigned short reg_regsel;
318 	unsigned short reg_data8;
319 	unsigned short reg_data16;
320 	unsigned short reg_irqstat;
321 	unsigned short reg_dram;
322 	unsigned short reg_timerctrl;
323 	unsigned short reg_timerdata;
324 	unsigned char ics_regs[6][2];
325 	/* --------- */
326 
327 	unsigned char active_voices;	/* active voices */
328 	unsigned char active_voice;	/* selected voice (GF1PAGE register) */
329 
330 	struct snd_gus_voice voices[32];	/* GF1 voices */
331 
332 	unsigned int default_voice_address;
333 
334 	unsigned short playback_freq;	/* GF1 playback (mixing) frequency */
335 	unsigned short mode;		/* see to SNDRV_GF1_MODE_XXXX */
336 	unsigned char volume_ramp;
337 	unsigned char smooth_pan;
338 	unsigned char full_range_pan;
339 	unsigned char pad0;
340 
341 	unsigned char *lfos;
342 
343 	/* interrupt handlers */
344 
345 	void (*interrupt_handler_midi_out) (struct snd_gus_card * gus);
346 	void (*interrupt_handler_midi_in) (struct snd_gus_card * gus);
347 	void (*interrupt_handler_timer1) (struct snd_gus_card * gus);
348 	void (*interrupt_handler_timer2) (struct snd_gus_card * gus);
349 	void (*interrupt_handler_dma_write) (struct snd_gus_card * gus);
350 	void (*interrupt_handler_dma_read) (struct snd_gus_card * gus);
351 
352 #ifdef CONFIG_SND_DEBUG
353 	unsigned int interrupt_stat_midi_out;
354 	unsigned int interrupt_stat_midi_in;
355 	unsigned int interrupt_stat_timer1;
356 	unsigned int interrupt_stat_timer2;
357 	unsigned int interrupt_stat_dma_write;
358 	unsigned int interrupt_stat_dma_read;
359 	unsigned int interrupt_stat_voice_lost;
360 #endif
361 
362 	/* synthesizer */
363 
364 	int seq_client;
365 	struct snd_gus_port seq_ports[4];
366 
367 	/* timer */
368 
369 	unsigned short timer_enabled;
370 	struct snd_timer *timer1;
371 	struct snd_timer *timer2;
372 
373 	/* midi */
374 
375 	unsigned short uart_cmd;
376 	unsigned int uart_framing;
377 	unsigned int uart_overrun;
378 
379 	/* dma operations */
380 
381 	unsigned int dma_flags;
382 	unsigned int dma_shared;
383 	struct snd_gf1_dma_block *dma_data_pcm;
384 	struct snd_gf1_dma_block *dma_data_pcm_last;
385 	struct snd_gf1_dma_block *dma_data_synth;
386 	struct snd_gf1_dma_block *dma_data_synth_last;
387 	void (*dma_ack)(struct snd_gus_card * gus, void *private_data);
388 	void *dma_private_data;
389 
390 	/* pcm */
391 	int pcm_channels;
392 	int pcm_alloc_voices;
393         unsigned short pcm_volume_level_left;
394 	unsigned short pcm_volume_level_right;
395 	unsigned short pcm_volume_level_left1;
396 	unsigned short pcm_volume_level_right1;
397 
398 	unsigned char pcm_rcntrl_reg;
399 	unsigned char pad_end;
400 };
401 
402 /* main structure for GUS card */
403 
404 struct snd_gus_card {
405 	struct snd_card *card;
406 
407 	unsigned int
408 	 initialized: 1,		/* resources were initialized */
409 	 equal_irq:1,			/* GF1 and CODEC shares IRQ (GUS MAX only) */
410 	 equal_dma:1,			/* if dma channels are equal (not valid for daughter board) */
411 	 ics_flag:1,			/* have we ICS mixer chip */
412 	 ics_flipped:1,			/* ICS mixer have flipped some channels? */
413 	 codec_flag:1,			/* have we CODEC chip? */
414 	 max_flag:1,			/* have we GUS MAX card? */
415 	 max_ctrl_flag:1,		/* have we original GUS MAX card? */
416 	 daughter_flag:1,		/* have we daughter board? */
417 	 interwave:1,			/* hey - we have InterWave card */
418 	 ess_flag:1,			/* ESS chip found... GUS Extreme */
419 	 ace_flag:1,			/* GUS ACE detected */
420 	 uart_enable:1;			/* enable MIDI UART */
421 	unsigned short revision;	/* revision of chip */
422 	unsigned short max_cntrl_val;	/* GUS MAX control value */
423 	unsigned short mix_cntrl_reg;	/* mixer control register */
424 	unsigned short joystick_dac;	/* joystick DAC level */
425 	int timer_dev;			/* timer device */
426 
427 	struct snd_gf1 gf1;	/* gf1 specific variables */
428 	struct snd_pcm *pcm;
429 	struct snd_pcm_substream *pcm_cap_substream;
430 	unsigned int c_dma_size;
431 	unsigned int c_period_size;
432 	unsigned int c_pos;
433 
434 	struct snd_rawmidi *midi_uart;
435 	struct snd_rawmidi_substream *midi_substream_output;
436 	struct snd_rawmidi_substream *midi_substream_input;
437 
438 	spinlock_t reg_lock;
439 	spinlock_t voice_alloc;
440 	spinlock_t active_voice_lock;
441 	spinlock_t event_lock;
442 	spinlock_t dma_lock;
443 	spinlock_t pcm_volume_level_lock;
444 	spinlock_t uart_cmd_lock;
445 	struct mutex dma_mutex;
446 	struct mutex register_mutex;
447 };
448 
449 /* I/O functions for GF1/InterWave chip - gus_io.c */
450 
451 static inline void snd_gf1_select_voice(struct snd_gus_card * gus, int voice)
452 {
453 	unsigned long flags;
454 
455 	spin_lock_irqsave(&gus->active_voice_lock, flags);
456 	if (voice != gus->gf1.active_voice) {
457 		gus->gf1.active_voice = voice;
458 		outb(voice, GUSP(gus, GF1PAGE));
459 	}
460 	spin_unlock_irqrestore(&gus->active_voice_lock, flags);
461 }
462 
463 static inline void snd_gf1_uart_cmd(struct snd_gus_card * gus, unsigned char b)
464 {
465 	outb(gus->gf1.uart_cmd = b, GUSP(gus, MIDICTRL));
466 }
467 
468 static inline unsigned char snd_gf1_uart_stat(struct snd_gus_card * gus)
469 {
470 	return inb(GUSP(gus, MIDISTAT));
471 }
472 
473 static inline void snd_gf1_uart_put(struct snd_gus_card * gus, unsigned char b)
474 {
475 	outb(b, GUSP(gus, MIDIDATA));
476 }
477 
478 static inline unsigned char snd_gf1_uart_get(struct snd_gus_card * gus)
479 {
480 	return inb(GUSP(gus, MIDIDATA));
481 }
482 
483 extern void snd_gf1_delay(struct snd_gus_card * gus);
484 
485 extern void snd_gf1_ctrl_stop(struct snd_gus_card * gus, unsigned char reg);
486 
487 extern void snd_gf1_write8(struct snd_gus_card * gus, unsigned char reg, unsigned char data);
488 extern unsigned char snd_gf1_look8(struct snd_gus_card * gus, unsigned char reg);
489 static inline unsigned char snd_gf1_read8(struct snd_gus_card * gus, unsigned char reg)
490 {
491 	return snd_gf1_look8(gus, reg | 0x80);
492 }
493 extern void snd_gf1_write16(struct snd_gus_card * gus, unsigned char reg, unsigned int data);
494 extern unsigned short snd_gf1_look16(struct snd_gus_card * gus, unsigned char reg);
495 static inline unsigned short snd_gf1_read16(struct snd_gus_card * gus, unsigned char reg)
496 {
497 	return snd_gf1_look16(gus, reg | 0x80);
498 }
499 extern void snd_gf1_adlib_write(struct snd_gus_card * gus, unsigned char reg, unsigned char data);
500 extern void snd_gf1_dram_addr(struct snd_gus_card * gus, unsigned int addr);
501 extern void snd_gf1_poke(struct snd_gus_card * gus, unsigned int addr, unsigned char data);
502 extern unsigned char snd_gf1_peek(struct snd_gus_card * gus, unsigned int addr);
503 extern void snd_gf1_write_addr(struct snd_gus_card * gus, unsigned char reg, unsigned int addr, short w_16bit);
504 extern unsigned int snd_gf1_read_addr(struct snd_gus_card * gus, unsigned char reg, short w_16bit);
505 extern void snd_gf1_i_ctrl_stop(struct snd_gus_card * gus, unsigned char reg);
506 extern void snd_gf1_i_write8(struct snd_gus_card * gus, unsigned char reg, unsigned char data);
507 extern unsigned char snd_gf1_i_look8(struct snd_gus_card * gus, unsigned char reg);
508 extern void snd_gf1_i_write16(struct snd_gus_card * gus, unsigned char reg, unsigned int data);
509 static inline unsigned char snd_gf1_i_read8(struct snd_gus_card * gus, unsigned char reg)
510 {
511 	return snd_gf1_i_look8(gus, reg | 0x80);
512 }
513 extern unsigned short snd_gf1_i_look16(struct snd_gus_card * gus, unsigned char reg);
514 static inline unsigned short snd_gf1_i_read16(struct snd_gus_card * gus, unsigned char reg)
515 {
516 	return snd_gf1_i_look16(gus, reg | 0x80);
517 }
518 
519 extern void snd_gf1_select_active_voices(struct snd_gus_card * gus);
520 
521 /* gus_lfo.c */
522 
523 struct _SND_IW_LFO_PROGRAM {
524 	unsigned short freq_and_control;
525 	unsigned char depth_final;
526 	unsigned char depth_inc;
527 	unsigned short twave;
528 	unsigned short depth;
529 };
530 
531 #if 0
532 extern irqreturn_t snd_gf1_lfo_effect_interrupt(struct snd_gus_card * gus, snd_gf1_voice_t * voice);
533 #endif
534 extern void snd_gf1_lfo_init(struct snd_gus_card * gus);
535 extern void snd_gf1_lfo_done(struct snd_gus_card * gus);
536 extern void snd_gf1_lfo_program(struct snd_gus_card * gus, int voice, int lfo_type, struct _SND_IW_LFO_PROGRAM *program);
537 extern void snd_gf1_lfo_enable(struct snd_gus_card * gus, int voice, int lfo_type);
538 extern void snd_gf1_lfo_disable(struct snd_gus_card * gus, int voice, int lfo_type);
539 extern void snd_gf1_lfo_change_freq(struct snd_gus_card * gus, int voice, int lfo_type, int freq);
540 extern void snd_gf1_lfo_change_depth(struct snd_gus_card * gus, int voice, int lfo_type, int depth);
541 extern void snd_gf1_lfo_setup(struct snd_gus_card * gus, int voice, int lfo_type, int freq, int current_depth, int depth, int sweep, int shape);
542 extern void snd_gf1_lfo_shutdown(struct snd_gus_card * gus, int voice, int lfo_type);
543 #if 0
544 extern void snd_gf1_lfo_command(struct snd_gus_card * gus, int voice, unsigned char *command);
545 #endif
546 
547 /* gus_mem.c */
548 
549 void snd_gf1_mem_lock(struct snd_gf1_mem * alloc, int xup);
550 int snd_gf1_mem_xfree(struct snd_gf1_mem * alloc, struct snd_gf1_mem_block * block);
551 struct snd_gf1_mem_block *snd_gf1_mem_alloc(struct snd_gf1_mem * alloc, int owner,
552 				       char *name, int size, int w_16,
553 				       int align, unsigned int *share_id);
554 int snd_gf1_mem_free(struct snd_gf1_mem * alloc, unsigned int address);
555 int snd_gf1_mem_free_owner(struct snd_gf1_mem * alloc, int owner);
556 int snd_gf1_mem_init(struct snd_gus_card * gus);
557 int snd_gf1_mem_done(struct snd_gus_card * gus);
558 
559 /* gus_mem_proc.c */
560 
561 int snd_gf1_mem_proc_init(struct snd_gus_card * gus);
562 
563 /* gus_dma.c */
564 
565 int snd_gf1_dma_init(struct snd_gus_card * gus);
566 int snd_gf1_dma_done(struct snd_gus_card * gus);
567 int snd_gf1_dma_transfer_block(struct snd_gus_card * gus,
568 			       struct snd_gf1_dma_block * block,
569 			       int atomic,
570 			       int synth);
571 
572 /* gus_volume.c */
573 
574 unsigned short snd_gf1_lvol_to_gvol_raw(unsigned int vol);
575 unsigned short snd_gf1_translate_freq(struct snd_gus_card * gus, unsigned int freq2);
576 
577 /* gus_reset.c */
578 
579 void snd_gf1_set_default_handlers(struct snd_gus_card * gus, unsigned int what);
580 void snd_gf1_smart_stop_voice(struct snd_gus_card * gus, unsigned short voice);
581 void snd_gf1_stop_voice(struct snd_gus_card * gus, unsigned short voice);
582 void snd_gf1_stop_voices(struct snd_gus_card * gus, unsigned short v_min, unsigned short v_max);
583 struct snd_gus_voice *snd_gf1_alloc_voice(struct snd_gus_card * gus, int type, int client, int port);
584 void snd_gf1_free_voice(struct snd_gus_card * gus, struct snd_gus_voice *voice);
585 int snd_gf1_start(struct snd_gus_card * gus);
586 int snd_gf1_stop(struct snd_gus_card * gus);
587 
588 /* gus_mixer.c */
589 
590 int snd_gf1_new_mixer(struct snd_gus_card * gus);
591 
592 /* gus_pcm.c */
593 
594 int snd_gf1_pcm_new(struct snd_gus_card *gus, int pcm_dev, int control_index);
595 
596 #ifdef CONFIG_SND_DEBUG
597 extern void snd_gf1_print_voice_registers(struct snd_gus_card * gus);
598 #endif
599 
600 /* gus.c */
601 
602 int snd_gus_use_inc(struct snd_gus_card * gus);
603 void snd_gus_use_dec(struct snd_gus_card * gus);
604 int snd_gus_create(struct snd_card *card,
605 		   unsigned long port,
606 		   int irq, int dma1, int dma2,
607 		   int timer_dev,
608 		   int voices,
609 		   int pcm_channels,
610 		   int effect,
611 		   struct snd_gus_card ** rgus);
612 int snd_gus_initialize(struct snd_gus_card * gus);
613 
614 /* gus_irq.c */
615 
616 irqreturn_t snd_gus_interrupt(int irq, void *dev_id);
617 #ifdef CONFIG_SND_DEBUG
618 void snd_gus_irq_profile_init(struct snd_gus_card *gus);
619 #endif
620 
621 /* gus_uart.c */
622 
623 int snd_gf1_rawmidi_new(struct snd_gus_card *gus, int device);
624 
625 /* gus_dram.c */
626 int snd_gus_dram_write(struct snd_gus_card *gus, char __user *ptr,
627 		       unsigned int addr, unsigned int size);
628 int snd_gus_dram_read(struct snd_gus_card *gus, char __user *ptr,
629 		      unsigned int addr, unsigned int size, int rom);
630 
631 #endif /* __SOUND_GUS_H */
632