Linux Audio

Check our new training course

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