• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  *	dev_table.h
3  *
4  *	Global definitions for device call tables
5  *
6  *
7  * Copyright (C) by Hannu Savolainen 1993-1997
8  *
9  * OSS/Free for Linux is distributed under the GNU GENERAL PUBLIC LICENSE (GPL)
10  * Version 2 (June 1991). See the "COPYING" file distributed with this software
11  * for more info.
12  */
13 
14 
15 #ifndef _DEV_TABLE_H_
16 #define _DEV_TABLE_H_
17 
18 #include <linux/spinlock.h>
19 /*
20  * Sound card numbers 27 to 999. (1 to 26 are defined in soundcard.h)
21  * Numbers 1000 to N are reserved for driver's internal use.
22  */
23 
24 #define SNDCARD_DESKPROXL		27	/* Compaq Deskpro XL */
25 #define SNDCARD_VIDC			28	/* ARMs VIDC */
26 #define SNDCARD_SBPNP			29
27 #define SNDCARD_SOFTOSS			36
28 #define SNDCARD_VMIDI			37
29 #define SNDCARD_OPL3SA1			38	/* Note: clash in msnd.h */
30 #define SNDCARD_OPL3SA1_SB		39
31 #define SNDCARD_OPL3SA1_MPU		40
32 #define SNDCARD_WAVEFRONT               41
33 #define SNDCARD_OPL3SA2                 42
34 #define SNDCARD_OPL3SA2_MPU             43
35 #define SNDCARD_WAVEARTIST              44	/* Waveartist */
36 #define SNDCARD_OPL3SA2_MSS             45	/* Originally missed */
37 #define SNDCARD_AD1816                  88
38 
39 /*
40  *	NOTE! 	NOTE!	NOTE!	NOTE!
41  *
42  *	If you modify this file, please check the dev_table.c also.
43  *
44  *	NOTE! 	NOTE!	NOTE!	NOTE!
45  */
46 
47 struct driver_info
48 {
49 	char *driver_id;
50 	int card_subtype;	/* Driver specific. Usually 0 */
51 	int card_type;		/*	From soundcard.h	*/
52 	char *name;
53 	void (*attach) (struct address_info *hw_config);
54 	int (*probe) (struct address_info *hw_config);
55 	void (*unload) (struct address_info *hw_config);
56 };
57 
58 struct card_info
59 {
60 	int card_type;	/* Link (search key) to the driver list */
61 	struct address_info config;
62 	int enabled;
63 	void *for_driver_use;
64 };
65 
66 
67 /*
68  * Device specific parameters (used only by dmabuf.c)
69  */
70 #define MAX_SUB_BUFFERS		(32*MAX_REALTIME_FACTOR)
71 
72 #define DMODE_NONE		0
73 #define DMODE_OUTPUT		PCM_ENABLE_OUTPUT
74 #define DMODE_INPUT		PCM_ENABLE_INPUT
75 
76 struct dma_buffparms
77 {
78 	int      dma_mode;	/* DMODE_INPUT, DMODE_OUTPUT or DMODE_NONE */
79 	int	 closing;
80 
81 	/*
82  	 * Pointers to raw buffers
83  	 */
84 
85   	char     *raw_buf;
86     	unsigned long   raw_buf_phys;
87 	int buffsize;
88 
89      	/*
90          * Device state tables
91          */
92 
93 	unsigned long flags;
94 #define DMA_BUSY	0x00000001
95 #define DMA_RESTART	0x00000002
96 #define DMA_ACTIVE	0x00000004
97 #define DMA_STARTED	0x00000008
98 #define DMA_EMPTY	0x00000010
99 #define DMA_ALLOC_DONE	0x00000020
100 #define DMA_SYNCING	0x00000040
101 #define DMA_DIRTY	0x00000080
102 #define DMA_POST	0x00000100
103 #define DMA_NODMA	0x00000200
104 #define DMA_NOTIMEOUT	0x00000400
105 
106 	int      open_mode;
107 
108 	/*
109 	 * Queue parameters.
110 	 */
111 	int      qlen;
112 	int      qhead;
113 	int      qtail;
114 	spinlock_t lock;
115 
116 	int	 cfrag;	/* Current incomplete fragment (write) */
117 
118 	int      nbufs;
119 	int      counts[MAX_SUB_BUFFERS];
120 	int      subdivision;
121 
122 	int      fragment_size;
123         int	 needs_reorg;
124 	int	 max_fragments;
125 
126 	int	 bytes_in_use;
127 
128 	int	 underrun_count;
129 	unsigned long	 byte_counter;
130 	unsigned long	 user_counter;
131 	unsigned long	 max_byte_counter;
132 	int	 data_rate; /* Bytes/second */
133 
134 	int	 mapping_flags;
135 #define			DMA_MAP_MAPPED		0x00000001
136 	char	neutral_byte;
137 	int	dma;		/* DMA channel */
138 
139 	int     applic_profile;	/* Application profile (APF_*) */
140 	/* Interrupt callback stuff */
141 	void (*audio_callback) (int dev, int parm);
142 	int callback_parm;
143 
144 	int	 buf_flags[MAX_SUB_BUFFERS];
145 #define		 BUFF_EOF		0x00000001 /* Increment eof count */
146 #define		 BUFF_DIRTY		0x00000002 /* Buffer written */
147 };
148 
149 /*
150  * Structure for use with various microcontrollers and DSP processors
151  * in the recent sound cards.
152  */
153 typedef struct coproc_operations
154 {
155 	char name[64];
156 	struct module *owner;
157 	int (*open) (void *devc, int sub_device);
158 	void (*close) (void *devc, int sub_device);
159 	int (*ioctl) (void *devc, unsigned int cmd, void __user * arg, int local);
160 	void (*reset) (void *devc);
161 
162 	void *devc;		/* Driver specific info */
163 } coproc_operations;
164 
165 struct audio_driver
166 {
167 	struct module *owner;
168 	int (*open) (int dev, int mode);
169 	void (*close) (int dev);
170 	void (*output_block) (int dev, unsigned long buf,
171 			      int count, int intrflag);
172 	void (*start_input) (int dev, unsigned long buf,
173 			     int count, int intrflag);
174 	int (*ioctl) (int dev, unsigned int cmd, void __user * arg);
175 	int (*prepare_for_input) (int dev, int bufsize, int nbufs);
176 	int (*prepare_for_output) (int dev, int bufsize, int nbufs);
177 	void (*halt_io) (int dev);
178 	int (*local_qlen)(int dev);
179 	void (*copy_user) (int dev,
180 			char *localbuf, int localoffs,
181                         const char __user *userbuf, int useroffs,
182                         int max_in, int max_out,
183                         int *used, int *returned,
184                         int len);
185 	void (*halt_input) (int dev);
186 	void (*halt_output) (int dev);
187 	void (*trigger) (int dev, int bits);
188 	int (*set_speed)(int dev, int speed);
189 	unsigned int (*set_bits)(int dev, unsigned int bits);
190 	short (*set_channels)(int dev, short channels);
191 	void (*postprocess_write)(int dev); 	/* Device spesific postprocessing for written data */
192 	void (*preprocess_read)(int dev); 	/* Device spesific preprocessing for read data */
193 	void (*mmap)(int dev);
194 };
195 
196 struct audio_operations
197 {
198         char name[128];
199 	int flags;
200 #define NOTHING_SPECIAL 	0x00
201 #define NEEDS_RESTART		0x01
202 #define DMA_AUTOMODE		0x02
203 #define DMA_DUPLEX		0x04
204 #define DMA_PSEUDO_AUTOMODE	0x08
205 #define DMA_HARDSTOP		0x10
206 #define DMA_EXACT		0x40
207 #define DMA_NORESET		0x80
208 	int  format_mask;	/* Bitmask for supported audio formats */
209 	void *devc;		/* Driver specific info */
210 	struct audio_driver *d;
211 	void *portc;		/* Driver specific info */
212 	struct dma_buffparms *dmap_in, *dmap_out;
213 	struct coproc_operations *coproc;
214 	int mixer_dev;
215 	int enable_bits;
216  	int open_mode;
217 	int go;
218 	int min_fragment;	/* 0 == unlimited */
219 	int max_fragment;	/* 0 == unlimited */
220 	int parent_dev;		/* 0 -> no parent, 1 to n -> parent=parent_dev+1 */
221 
222 	/* fields formerly in dmabuf.c */
223 	wait_queue_head_t in_sleeper;
224 	wait_queue_head_t out_sleeper;
225 	wait_queue_head_t poll_sleeper;
226 
227 	/* fields formerly in audio.c */
228 	int audio_mode;
229 
230 #define		AM_NONE		0
231 #define		AM_WRITE	OPEN_WRITE
232 #define 	AM_READ		OPEN_READ
233 
234 	int local_format;
235 	int audio_format;
236 	int local_conversion;
237 #define CNV_MU_LAW	0x00000001
238 
239 	/* large structures at the end to keep offsets small */
240 	struct dma_buffparms dmaps[2];
241 };
242 
243 int *load_mixer_volumes(char *name, int *levels, int present);
244 
245 struct mixer_operations
246 {
247 	struct module *owner;
248 	char id[16];
249 	char name[64];
250 	int (*ioctl) (int dev, unsigned int cmd, void __user * arg);
251 
252 	void *devc;
253 	int modify_counter;
254 };
255 
256 struct synth_operations
257 {
258 	struct module *owner;
259 	char *id;	/* Unique identifier (ASCII) max 29 char */
260 	struct synth_info *info;
261 	int midi_dev;
262 	int synth_type;
263 	int synth_subtype;
264 
265 	int (*open) (int dev, int mode);
266 	void (*close) (int dev);
267 	int (*ioctl) (int dev, unsigned int cmd, void __user * arg);
268 	int (*kill_note) (int dev, int voice, int note, int velocity);
269 	int (*start_note) (int dev, int voice, int note, int velocity);
270 	int (*set_instr) (int dev, int voice, int instr);
271 	void (*reset) (int dev);
272 	void (*hw_control) (int dev, unsigned char *event);
273 	int (*load_patch) (int dev, int format, const char __user *addr,
274 	     int count, int pmgr_flag);
275 	void (*aftertouch) (int dev, int voice, int pressure);
276 	void (*controller) (int dev, int voice, int ctrl_num, int value);
277 	void (*panning) (int dev, int voice, int value);
278 	void (*volume_method) (int dev, int mode);
279 	void (*bender) (int dev, int chn, int value);
280 	int (*alloc_voice) (int dev, int chn, int note, struct voice_alloc_info *alloc);
281 	void (*setup_voice) (int dev, int voice, int chn);
282 	int (*send_sysex)(int dev, unsigned char *bytes, int len);
283 
284  	struct voice_alloc_info alloc;
285  	struct channel_info chn_info[16];
286 	int emulation;
287 #define	EMU_GM			1	/* General MIDI */
288 #define	EMU_XG			2	/* Yamaha XG */
289 #define MAX_SYSEX_BUF	64
290 	unsigned char sysex_buf[MAX_SYSEX_BUF];
291 	int sysex_ptr;
292 };
293 
294 struct midi_input_info
295 {
296 	/* MIDI input scanner variables */
297 #define MI_MAX	10
298 	volatile int             m_busy;
299     	unsigned char   m_buf[MI_MAX];
300 	unsigned char	m_prev_status;	/* For running status */
301     	int             m_ptr;
302 #define MST_INIT			0
303 #define MST_DATA			1
304 #define MST_SYSEX			2
305     	int             m_state;
306     	int             m_left;
307 };
308 
309 struct midi_operations
310 {
311 	struct module *owner;
312 	struct midi_info info;
313 	struct synth_operations *converter;
314 	struct midi_input_info in_info;
315 	int (*open) (int dev, int mode,
316 		void (*inputintr)(int dev, unsigned char data),
317 		void (*outputintr)(int dev)
318 		);
319 	void (*close) (int dev);
320 	int (*ioctl) (int dev, unsigned int cmd, void __user * arg);
321 	int (*outputc) (int dev, unsigned char data);
322 	int (*start_read) (int dev);
323 	int (*end_read) (int dev);
324 	void (*kick)(int dev);
325 	int (*command) (int dev, unsigned char *data);
326 	int (*buffer_status) (int dev);
327 	int (*prefix_cmd) (int dev, unsigned char status);
328 	struct coproc_operations *coproc;
329 	void *devc;
330 };
331 
332 struct sound_lowlev_timer
333 {
334 	int dev;
335 	int priority;
336 	unsigned int (*tmr_start)(int dev, unsigned int usecs);
337 	void (*tmr_disable)(int dev);
338 	void (*tmr_restart)(int dev);
339 };
340 
341 struct sound_timer_operations
342 {
343 	struct module *owner;
344 	struct sound_timer_info info;
345 	int priority;
346 	int devlink;
347 	int (*open)(int dev, int mode);
348 	void (*close)(int dev);
349 	int (*event)(int dev, unsigned char *ev);
350 	unsigned long (*get_time)(int dev);
351 	int (*ioctl) (int dev, unsigned int cmd, void __user * arg);
352 	void (*arm_timer)(int dev, long time);
353 };
354 
355 extern struct sound_timer_operations default_sound_timer;
356 
357 extern struct audio_operations *audio_devs[MAX_AUDIO_DEV];
358 extern int num_audiodevs;
359 extern struct mixer_operations *mixer_devs[MAX_MIXER_DEV];
360 extern int num_mixers;
361 extern struct synth_operations *synth_devs[MAX_SYNTH_DEV+MAX_MIDI_DEV];
362 extern int num_synths;
363 extern struct midi_operations *midi_devs[MAX_MIDI_DEV];
364 extern int num_midis;
365 extern struct sound_timer_operations * sound_timer_devs[MAX_TIMER_DEV];
366 extern int num_sound_timers;
367 
368 extern int sound_map_buffer (int dev, struct dma_buffparms *dmap, buffmem_desc *info);
369 void sound_timer_init (struct sound_lowlev_timer *t, char *name);
370 void sound_dma_intr (int dev, struct dma_buffparms *dmap, int chan);
371 
372 #define AUDIO_DRIVER_VERSION	2
373 #define MIXER_DRIVER_VERSION	2
374 int sound_install_audiodrv(int vers, char *name, struct audio_driver *driver,
375 			int driver_size, int flags, unsigned int format_mask,
376 			void *devc, int dma1, int dma2);
377 int sound_install_mixer(int vers, char *name, struct mixer_operations *driver,
378 			int driver_size, void *devc);
379 
380 void sound_unload_audiodev(int dev);
381 void sound_unload_mixerdev(int dev);
382 void sound_unload_mididev(int dev);
383 void sound_unload_synthdev(int dev);
384 void sound_unload_timerdev(int dev);
385 int sound_alloc_mixerdev(void);
386 int sound_alloc_timerdev(void);
387 int sound_alloc_synthdev(void);
388 int sound_alloc_mididev(void);
389 #endif	/* _DEV_TABLE_H_ */
390 
391