soundcard.h revision 9750
19750Sjkh#ifndef SOUNDCARD_H
29750Sjkh#define SOUNDCARD_H
3652Sjkh/*
4652Sjkh * Copyright by Hannu Savolainen 1993
5652Sjkh *
6652Sjkh * Redistribution and use in source and binary forms, with or without
7652Sjkh * modification, are permitted provided that the following conditions
8652Sjkh * are met:
9652Sjkh * 1. Redistributions of source code must retain the above copyright
10652Sjkh *    notice, this list of conditions and the following disclaimer.
11652Sjkh * 2. Redistributions in binary form must reproduce the above copyright
12652Sjkh *    notice, this list of conditions and the following disclaimer in the
13652Sjkh *    documentation and/or other materials provided with the distribution.
14652Sjkh *
15805Sache * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16652Sjkh * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17652Sjkh * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18805Sache * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19652Sjkh * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20652Sjkh * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21652Sjkh * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22652Sjkh * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23652Sjkh * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24652Sjkh * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25652Sjkh * SUCH DAMAGE.
26652Sjkh *
279750Sjkh *
28652Sjkh */
29652Sjkh
309750Sjkh /*
31652Sjkh  * If you make modifications to this file, please contact me before
329750Sjkh  * distributing the modified version. There is already enough
331258Sswallace  * divercity in the world.
34652Sjkh  *
35652Sjkh  * Regards,
36652Sjkh  * Hannu Savolainen
373256Sswallace  * hannu@voxware.pp.fi
38652Sjkh  */
39652Sjkh
409750Sjkh#define SOUND_VERSION	301
411258Sswallace#define VOXWARE
42652Sjkh
43652Sjkh#include <sys/ioctl.h>
44652Sjkh
45652Sjkh/*
46652Sjkh *	Supported card ID numbers (Should be somewhere else?)
47652Sjkh */
48652Sjkh
493256Sswallace#define SNDCARD_ADLIB		1
503256Sswallace#define SNDCARD_SB		2
513256Sswallace#define SNDCARD_PAS		3
523256Sswallace#define SNDCARD_GUS		4
533256Sswallace#define SNDCARD_MPU401		5
543256Sswallace#define SNDCARD_SB16		6
553256Sswallace#define SNDCARD_SB16MIDI	7
563256Sswallace#define SNDCARD_UART6850	8
573256Sswallace#define SNDCARD_GUS16		9
583256Sswallace#define SNDCARD_MSS		10
593256Sswallace#define SNDCARD_PSS     	11
609750Sjkh#define SNDCARD_SSCAPE		12
619750Sjkh#define SNDCARD_PSS_MPU     	13
629750Sjkh#define SNDCARD_PSS_MSS     	14
639750Sjkh#define SNDCARD_SSCAPE_MSS	15
649750Sjkh#define SNDCARD_TRXPRO		16
659750Sjkh#define SNDCARD_TRXPRO_SB	17
669750Sjkh#define SNDCARD_TRXPRO_MPU	18
67652Sjkh
68652Sjkh/***********************************
69652Sjkh * IOCTL Commands for /dev/sequencer
70652Sjkh */
71652Sjkh
729750Sjkh#ifndef _IOWR
739750Sjkh/*	@(#)ioctlp.h */
74652Sjkh
759750Sjkh/* Ioctl's have the command encoded in the lower word,
769750Sjkh * and the size of any in or out parameters in the upper
779750Sjkh * word.  The high 2 bits of the upper word are used
789750Sjkh * to encode the in/out status of the parameter; for now
799750Sjkh * we restrict parameters to at most 128 bytes.
809750Sjkh */
819750Sjkh/* #define	IOCTYPE		(0xff<<8) */
829750Sjkh#define	IOCPARM_MASK	0x7f		/* parameters must be < 128 bytes */
839750Sjkh#define	IOC_VOID	0x00000000	/* no parameters */
849750Sjkh#define	IOC_OUT		0x20000000	/* copy out parameters */
859750Sjkh#define	IOC_IN		0x40000000	/* copy in parameters */
869750Sjkh#define	IOC_INOUT	(IOC_IN|IOC_OUT)
879750Sjkh/* the 0x20000000 is so we can distinguish new ioctl's from old */
889750Sjkh#define	_IO(x,y)	((int)(IOC_VOID|(x<<8)|y))
899750Sjkh#define	_IOR(x,y,t)	((int)(IOC_OUT|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
909750Sjkh#define	_IOW(x,y,t)	((int)(IOC_IN|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
919750Sjkh/* this should be _IORW, but stdio got there first */
929750Sjkh#define	_IOWR(x,y,t)	((int)(IOC_INOUT|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
939750Sjkh#endif  /* !_IOWR */
949750Sjkh
95652Sjkh#define SNDCTL_SEQ_RESET		_IO  ('Q', 0)
96652Sjkh#define SNDCTL_SEQ_SYNC			_IO  ('Q', 1)
97652Sjkh#define SNDCTL_SYNTH_INFO		_IOWR('Q', 2, struct synth_info)
98652Sjkh#define SNDCTL_SEQ_CTRLRATE		_IOWR('Q', 3, int)	/* Set/get timer resolution (HZ) */
99652Sjkh#define SNDCTL_SEQ_GETOUTCOUNT		_IOR ('Q', 4, int)
100652Sjkh#define SNDCTL_SEQ_GETINCOUNT		_IOR ('Q', 5, int)
101652Sjkh#define SNDCTL_SEQ_PERCMODE		_IOW ('Q', 6, int)
102652Sjkh#define SNDCTL_FM_LOAD_INSTR		_IOW ('Q', 7, struct sbi_instrument)	/* Valid for FM only */
103652Sjkh#define SNDCTL_SEQ_TESTMIDI		_IOW ('Q', 8, int)
104652Sjkh#define SNDCTL_SEQ_RESETSAMPLES		_IOW ('Q', 9, int)
105652Sjkh#define SNDCTL_SEQ_NRSYNTHS		_IOR ('Q',10, int)
106652Sjkh#define SNDCTL_SEQ_NRMIDIS		_IOR ('Q',11, int)
107652Sjkh#define SNDCTL_MIDI_INFO		_IOWR('Q',12, struct midi_info)
108652Sjkh#define SNDCTL_SEQ_TRESHOLD		_IOW ('Q',13, int)
109652Sjkh#define SNDCTL_SYNTH_MEMAVL		_IOWR('Q',14, int)	/* in=dev#, out=memsize */
110652Sjkh#define SNDCTL_FM_4OP_ENABLE		_IOW ('Q',15, int)	/* in=dev# */
111652Sjkh#define SNDCTL_PMGR_ACCESS		_IOWR('Q',16, struct patmgr_info)
1123256Sswallace#define SNDCTL_SEQ_PANIC		_IO  ('Q',17)
1139750Sjkh#define SNDCTL_SEQ_OUTOFBAND		_IOW ('Q',18, struct seq_event_rec)
114652Sjkh
1159750Sjkh	struct seq_event_rec {
1169750Sjkh			unsigned char arr[8];
1179750Sjkh		};
1189750Sjkh
1193256Sswallace#define SNDCTL_TMR_TIMEBASE		_IOWR('T', 1, int)
1203256Sswallace#define SNDCTL_TMR_START		_IO  ('T', 2)
1213256Sswallace#define SNDCTL_TMR_STOP			_IO  ('T', 3)
1223256Sswallace#define SNDCTL_TMR_CONTINUE		_IO  ('T', 4)
1233256Sswallace#define SNDCTL_TMR_TEMPO		_IOWR('T', 5, int)
1243256Sswallace#define SNDCTL_TMR_SOURCE		_IOWR('T', 6, int)
1253256Sswallace#	define TMR_INTERNAL		0x00000001
1263256Sswallace#	define TMR_EXTERNAL		0x00000002
1273256Sswallace#		define TMR_MODE_MIDI	0x00000010
1283256Sswallace#		define TMR_MODE_FSK	0x00000020
1293256Sswallace#		define TMR_MODE_CLS	0x00000040
1303256Sswallace#		define TMR_MODE_SMPTE	0x00000080
1313256Sswallace#define SNDCTL_TMR_METRONOME		_IOW ('T', 7, int)
1323256Sswallace#define SNDCTL_TMR_SELECT		_IOW ('T', 8, int)
1333256Sswallace
134652Sjkh/*
135652Sjkh *	Sample loading mechanism for internal synthesizers (/dev/sequencer)
136652Sjkh *	The following patch_info structure has been designed to support
137652Sjkh *	Gravis UltraSound. It tries to be universal format for uploading
138652Sjkh *	sample based patches but is propably too limited.
139652Sjkh */
140652Sjkh
141652Sjkhstruct patch_info {
142652Sjkh		short key;		/* Use GUS_PATCH here */
143652Sjkh#define GUS_PATCH	0x04fd
144652Sjkh#define OBSOLETE_GUS_PATCH	0x02fd
145652Sjkh		short device_no;	/* Synthesizer number */
146652Sjkh		short instr_no;		/* Midi pgm# */
147652Sjkh
148652Sjkh		unsigned long mode;
149652Sjkh/*
150652Sjkh * The least significant byte has the same format than the GUS .PAT
151652Sjkh * files
152652Sjkh */
153652Sjkh#define WAVE_16_BITS	0x01	/* bit 0 = 8 or 16 bit wave data. */
154652Sjkh#define WAVE_UNSIGNED	0x02	/* bit 1 = Signed - Unsigned data. */
155652Sjkh#define WAVE_LOOPING	0x04	/* bit 2 = looping enabled-1. */
156652Sjkh#define WAVE_BIDIR_LOOP	0x08	/* bit 3 = Set is bidirectional looping. */
157652Sjkh#define WAVE_LOOP_BACK	0x10	/* bit 4 = Set is looping backward. */
158652Sjkh#define WAVE_SUSTAIN_ON	0x20	/* bit 5 = Turn sustaining on. (Env. pts. 3)*/
159652Sjkh#define WAVE_ENVELOPES	0x40	/* bit 6 = Enable envelopes - 1 */
160652Sjkh				/* 	(use the env_rate/env_offs fields). */
161652Sjkh/* Linux specific bits */
162652Sjkh#define WAVE_VIBRATO	0x00010000	/* The vibrato info is valid */
163652Sjkh#define WAVE_TREMOLO	0x00020000	/* The tremolo info is valid */
164652Sjkh#define WAVE_SCALE	0x00040000	/* The scaling info is valid */
165652Sjkh/* Other bits must be zeroed */
166652Sjkh
167652Sjkh		long len;	/* Size of the wave data in bytes */
168652Sjkh		long loop_start, loop_end; /* Byte offsets from the beginning */
169652Sjkh
1709750Sjkh/*
171652Sjkh * The base_freq and base_note fields are used when computing the
172652Sjkh * playback speed for a note. The base_note defines the tone frequency
173652Sjkh * which is heard if the sample is played using the base_freq as the
174652Sjkh * playback speed.
175652Sjkh *
176652Sjkh * The low_note and high_note fields define the minimum and maximum note
177652Sjkh * frequencies for which this sample is valid. It is possible to define
178652Sjkh * more than one samples for a instrument number at the same time. The
179652Sjkh * low_note and high_note fields are used to select the most suitable one.
180652Sjkh *
181652Sjkh * The fields base_note, high_note and low_note should contain
182652Sjkh * the note frequency multiplied by 1000. For example value for the
183652Sjkh * middle A is 440*1000.
184652Sjkh */
185652Sjkh
186652Sjkh		unsigned int base_freq;
187652Sjkh		unsigned long base_note;
188652Sjkh		unsigned long high_note;
189652Sjkh		unsigned long low_note;
190652Sjkh		int panning;	/* -128=left, 127=right */
191652Sjkh		int detuning;
192652Sjkh
193652Sjkh/*	New fields introduced in version 1.99.5	*/
194652Sjkh
195652Sjkh       /* Envelope. Enabled by mode bit WAVE_ENVELOPES	*/
196652Sjkh		unsigned char	env_rate[ 6 ];	 /* GUS HW ramping rate */
197652Sjkh		unsigned char	env_offset[ 6 ]; /* 255 == 100% */
198652Sjkh
1999750Sjkh	/*
200652Sjkh	 * The tremolo, vibrato and scale info are not supported yet.
201652Sjkh	 * Enable by setting the mode bits WAVE_TREMOLO, WAVE_VIBRATO or
202652Sjkh	 * WAVE_SCALE
203652Sjkh	 */
204652Sjkh
205652Sjkh		unsigned char	tremolo_sweep;
206652Sjkh		unsigned char	tremolo_rate;
207652Sjkh		unsigned char	tremolo_depth;
2089750Sjkh
209652Sjkh		unsigned char	vibrato_sweep;
210652Sjkh		unsigned char	vibrato_rate;
211652Sjkh		unsigned char	vibrato_depth;
212652Sjkh
213652Sjkh		int		scale_frequency;
214652Sjkh		unsigned int	scale_factor;		/* from 0 to 2048 or 0 to 2 */
2159750Sjkh
216652Sjkh	        int		volume;
217652Sjkh	        int		spare[4];
2181258Sswallace		char data[1];	/* The waveform data starts here */
219652Sjkh	};
220652Sjkh
221652Sjkh
2223256Sswallacestruct sysex_info {
2233256Sswallace		short key;		/* Use GUS_PATCH here */
2243256Sswallace#define SYSEX_PATCH	0x05fd
2253256Sswallace		short device_no;	/* Synthesizer number */
2263256Sswallace		long len;	/* Size of the sysex data in bytes */
2273256Sswallace		unsigned char data[1];	/* Sysex data starts here */
2283256Sswallace	};
2293256Sswallace
230652Sjkh/*
231652Sjkh * Patch management interface (/dev/sequencer, /dev/patmgr#)
232652Sjkh * Don't use these calls if you want to maintain compatibility with
233652Sjkh * the future versions of the driver.
234652Sjkh */
235652Sjkh
236652Sjkh#define 	PS_NO_PATCHES		0	/* No patch support on device */
237652Sjkh#define		PS_MGR_NOT_OK		1	/* Plain patch support (no mgr) */
238652Sjkh#define		PS_MGR_OK		2	/* Patch manager supported */
239652Sjkh#define		PS_MANAGED		3	/* Patch manager running */
240652Sjkh
241652Sjkh#define SNDCTL_PMGR_IFACE		_IOWR('P', 1, struct patmgr_info)
242652Sjkh
243652Sjkh/*
244652Sjkh * The patmgr_info is a fixed size structure which is used for two
245652Sjkh * different purposes. The intended use is for communication between
246652Sjkh * the application using /dev/sequencer and the patch manager daemon
247652Sjkh * associated with a synthesizer device (ioctl(SNDCTL_PMGR_ACCESS)).
248652Sjkh *
249652Sjkh * This structure is also used with ioctl(SNDCTL_PGMR_IFACE) which allows
250652Sjkh * a patch manager daemon to read and write device parameters. This
251652Sjkh * ioctl available through /dev/sequencer also. Avoid using it since it's
2529750Sjkh * extremely hardware dependent. In addition access trough /dev/sequencer
253652Sjkh * may confuse the patch manager daemon.
254652Sjkh */
255652Sjkh
256652Sjkhstruct patmgr_info {	/* Note! size must be < 4k since kmalloc() is used */
257652Sjkh	  unsigned long key;	/* Don't worry. Reserved for communication
258652Sjkh	  			   between the patch manager and the driver. */
259652Sjkh#define PM_K_EVENT		1 /* Event from the /dev/sequencer driver */
260652Sjkh#define PM_K_COMMAND		2 /* Request from a application */
261652Sjkh#define PM_K_RESPONSE		3 /* From patmgr to application */
262652Sjkh#define PM_ERROR		4 /* Error returned by the patmgr */
263652Sjkh	  int device;
264652Sjkh	  int command;
265652Sjkh
2669750Sjkh/*
2679750Sjkh * Commands 0x000 to 0xfff reserved for patch manager programs
268652Sjkh */
269652Sjkh#define PM_GET_DEVTYPE	1	/* Returns type of the patch mgr interface of dev */
270652Sjkh#define		PMTYPE_FM2	1	/* 2 OP fm */
271652Sjkh#define		PMTYPE_FM4	2	/* Mixed 4 or 2 op FM (OPL-3) */
272652Sjkh#define		PMTYPE_WAVE	3	/* Wave table synthesizer (GUS) */
273652Sjkh#define PM_GET_NRPGM	2	/* Returns max # of midi programs in parm1 */
274652Sjkh#define PM_GET_PGMMAP	3	/* Returns map of loaded midi programs in data8 */
275652Sjkh#define PM_GET_PGM_PATCHES 4	/* Return list of patches of a program (parm1) */
276652Sjkh#define PM_GET_PATCH	5	/* Return patch header of patch parm1 */
277652Sjkh#define PM_SET_PATCH	6	/* Set patch header of patch parm1 */
278652Sjkh#define PM_READ_PATCH	7	/* Read patch (wave) data */
279652Sjkh#define PM_WRITE_PATCH	8	/* Write patch (wave) data */
280652Sjkh
281652Sjkh/*
282652Sjkh * Commands 0x1000 to 0xffff are for communication between the patch manager
283652Sjkh * and the client
284652Sjkh */
285652Sjkh#define _PM_LOAD_PATCH	0x100
286652Sjkh
2879750Sjkh/*
288652Sjkh * Commands above 0xffff reserved for device specific use
289652Sjkh */
290652Sjkh
291652Sjkh	  long parm1;
292652Sjkh	  long parm2;
293652Sjkh	  long parm3;
294652Sjkh
295652Sjkh	  union {
296652Sjkh		unsigned char data8[4000];
297652Sjkh		unsigned short data16[2000];
298652Sjkh		unsigned long data32[1000];
299652Sjkh		struct patch_info patch;
300652Sjkh	  } data;
301652Sjkh	};
302652Sjkh
303652Sjkh/*
304652Sjkh * When a patch manager daemon is present, it will be informed by the
305652Sjkh * driver when something important happens. For example when the
306652Sjkh * /dev/sequencer is opened or closed. A record with key == PM_K_EVENT is
307652Sjkh * returned. The command field contains the event type:
308652Sjkh */
309652Sjkh#define PM_E_OPENED		1	/* /dev/sequencer opened */
310652Sjkh#define PM_E_CLOSED		2	/* /dev/sequencer closed */
311652Sjkh#define PM_E_PATCH_RESET	3	/* SNDCTL_RESETSAMPLES called */
312652Sjkh#define PM_E_PATCH_LOADED	4	/* A patch has been loaded by appl */
313652Sjkh
314652Sjkh/*
315652Sjkh * /dev/sequencer input events.
316652Sjkh *
317652Sjkh * The data written to the /dev/sequencer is a stream of events. Events
3189750Sjkh * are records of 4 or 8 bytes. The first byte defines the size.
319652Sjkh * Any number of events can be written with a write call. There
320652Sjkh * is a set of macros for sending these events. Use these macros if you
321652Sjkh * want to maximize portability of your program.
322652Sjkh *
323652Sjkh * Events SEQ_WAIT, SEQ_MIDIPUTC and SEQ_ECHO. Are also input events.
324652Sjkh * (All input events are currently 4 bytes long. Be prepared to support
3253256Sswallace * 8 byte events also. If you receive any event having first byte >= 128,
326652Sjkh * it's a 8 byte event.
327652Sjkh *
328652Sjkh * The events are documented at the end of this file.
329652Sjkh *
330652Sjkh * Normal events (4 bytes)
331652Sjkh * There is also a 8 byte version of most of the 4 byte events. The
332652Sjkh * 8 byte one is recommended.
333652Sjkh */
334652Sjkh#define SEQ_NOTEOFF		0
335652Sjkh#define SEQ_FMNOTEOFF		SEQ_NOTEOFF	/* Just old name */
336652Sjkh#define SEQ_NOTEON		1
337652Sjkh#define	SEQ_FMNOTEON		SEQ_NOTEON
3383256Sswallace#define SEQ_WAIT		TMR_WAIT_ABS
339652Sjkh#define SEQ_PGMCHANGE		3
340652Sjkh#define SEQ_FMPGMCHANGE		SEQ_PGMCHANGE
3413256Sswallace#define SEQ_SYNCTIMER		TMR_START
342652Sjkh#define SEQ_MIDIPUTC		5
343652Sjkh#define SEQ_DRUMON		6	/*** OBSOLETE ***/
344652Sjkh#define SEQ_DRUMOFF		7	/*** OBSOLETE ***/
3453256Sswallace#define SEQ_ECHO		TMR_ECHO	/* For synching programs with output */
346652Sjkh#define SEQ_AFTERTOUCH		9
347652Sjkh#define SEQ_CONTROLLER		10
3483256Sswallace
3493256Sswallace/*******************************************
3503256Sswallace *	Midi controller numbers
3513256Sswallace *******************************************
3523256Sswallace * Controllers 0 to 31 (0x00 to 0x1f) and
3533256Sswallace * 32 to 63 (0x20 to 0x3f) are continuous
3543256Sswallace * controllers.
3553256Sswallace * In the MIDI 1.0 these controllers are sent using
3563256Sswallace * two messages. Controller numbers 0 to 31 are used
3579750Sjkh * to send the MSB and the controller numbers 32 to 63
3589750Sjkh * are for the LSB. Note that just 7 bits are used in MIDI bytes.
3593256Sswallace */
3603256Sswallace
3613256Sswallace#define	   CTL_BANK_SELECT		0x00
3623256Sswallace#define	   CTL_MODWHEEL			0x01
3633256Sswallace#define    CTL_BREATH			0x02
3643256Sswallace/*		undefined		0x03 */
3653256Sswallace#define    CTL_FOOT			0x04
3663256Sswallace#define    CTL_PORTAMENTO_TIME		0x05
3673256Sswallace#define    CTL_DATA_ENTRY		0x06
3683256Sswallace#define    CTL_MAIN_VOLUME		0x07
3693256Sswallace#define    CTL_BALANCE			0x08
3703256Sswallace/*		undefined		0x09 */
3713256Sswallace#define    CTL_PAN			0x0a
3723256Sswallace#define    CTL_EXPRESSION		0x0b
3733256Sswallace/*		undefined		0x0c */
3743256Sswallace/*		undefined		0x0d */
3753256Sswallace/*		undefined		0x0e */
3763256Sswallace/*		undefined		0x0f */
3773256Sswallace#define    CTL_GENERAL_PURPOSE1	0x10
3783256Sswallace#define    CTL_GENERAL_PURPOSE2	0x11
3793256Sswallace#define    CTL_GENERAL_PURPOSE3	0x12
3803256Sswallace#define    CTL_GENERAL_PURPOSE4	0x13
3813256Sswallace/*		undefined		0x14 - 0x1f */
3823256Sswallace
3833256Sswallace/*		undefined		0x20 */
3843256Sswallace/* The controller numbers 0x21 to 0x3f are reserved for the */
3853256Sswallace/* least significant bytes of the controllers 0x00 to 0x1f. */
3863256Sswallace/* These controllers are not recognised by the driver. */
3873256Sswallace
3883256Sswallace/* Controllers 64 to 69 (0x40 to 0x45) are on/off switches. */
3893256Sswallace/* 0=OFF and 127=ON (intermediate values are possible) */
3903256Sswallace#define    CTL_DAMPER_PEDAL		0x40
3913256Sswallace#define    CTL_SUSTAIN			0x40	/* Alias */
3923256Sswallace#define    CTL_HOLD			0x40	/* Alias */
3933256Sswallace#define    CTL_PORTAMENTO		0x41
3943256Sswallace#define    CTL_SOSTENUTO		0x42
3953256Sswallace#define    CTL_SOFT_PEDAL		0x43
3963256Sswallace/*		undefined		0x44 */
3973256Sswallace#define    CTL_HOLD2			0x45
3983256Sswallace/*		undefined		0x46 - 0x4f */
3993256Sswallace
4003256Sswallace#define    CTL_GENERAL_PURPOSE5	0x50
4013256Sswallace#define    CTL_GENERAL_PURPOSE6	0x51
4023256Sswallace#define    CTL_GENERAL_PURPOSE7	0x52
4033256Sswallace#define    CTL_GENERAL_PURPOSE8	0x53
4043256Sswallace/*		undefined		0x54 - 0x5a */
4053256Sswallace#define    CTL_EXT_EFF_DEPTH		0x5b
4063256Sswallace#define    CTL_TREMOLO_DEPTH		0x5c
4073256Sswallace#define    CTL_CHORUS_DEPTH		0x5d
4083256Sswallace#define    CTL_DETUNE_DEPTH		0x5e
4093256Sswallace#define    CTL_CELESTE_DEPTH		0x5e	/* Alias for the above one */
4103256Sswallace#define    CTL_PHASER_DEPTH		0x5f
4113256Sswallace#define    CTL_DATA_INCREMENT		0x60
4123256Sswallace#define    CTL_DATA_DECREMENT		0x61
4133256Sswallace#define    CTL_NONREG_PARM_NUM_LSB	0x62
4143256Sswallace#define    CTL_NONREG_PARM_NUM_MSB	0x63
4153256Sswallace#define    CTL_REGIST_PARM_NUM_LSB	0x64
4163256Sswallace#define    CTL_REGIST_PARM_NUM_MSB	0x65
4173256Sswallace/*		undefined		0x66 - 0x78 */
4183256Sswallace/*		reserved		0x79 - 0x7f */
4193256Sswallace
4203256Sswallace/* Pseudo controllers (not midi compatible) */
421652Sjkh#define    CTRL_PITCH_BENDER		255
422652Sjkh#define    CTRL_PITCH_BENDER_RANGE	254
4233256Sswallace#define    CTRL_EXPRESSION		253	/* Obsolete */
4243256Sswallace#define    CTRL_MAIN_VOLUME		252	/* Obsolete */
425652Sjkh#define SEQ_BALANCE		11
4261402Sache#define SEQ_VOLMODE             12
427652Sjkh
428652Sjkh/*
4291402Sache * Volume mode decides how volumes are used
4301402Sache */
4311402Sache
4321402Sache#define VOL_METHOD_ADAGIO	1
4331402Sache#define VOL_METHOD_LINEAR	2
4341402Sache
4351402Sache/*
436652Sjkh * Note! SEQ_WAIT, SEQ_MIDIPUTC and SEQ_ECHO are used also as
437652Sjkh *	 input events.
438652Sjkh */
439652Sjkh
440652Sjkh/*
441652Sjkh * Event codes 0xf0 to 0xfc are reserved for future extensions.
442652Sjkh */
443652Sjkh
444652Sjkh#define SEQ_FULLSIZE		0xfd	/* Long events */
445652Sjkh/*
446652Sjkh *	SEQ_FULLSIZE events are used for loading patches/samples to the
447652Sjkh *	synthesizer devices. These events are passed directly to the driver
448652Sjkh *	of the associated synthesizer device. There is no limit to the size
449652Sjkh *	of the extended events. These events are not queued but executed
450652Sjkh *	immediately when the write() is called (execution can take several
4519750Sjkh *	seconds of time).
452652Sjkh *
453652Sjkh *	When a SEQ_FULLSIZE message is written to the device, it must
454652Sjkh *	be written using exactly one write() call. Other events cannot
455652Sjkh *	be mixed to the same write.
4569750Sjkh *
4579750Sjkh *	For FM synths (YM3812/OPL3) use struct sbi_instrument and write it to the
458652Sjkh *	/dev/sequencer. Don't write other data together with the instrument structure
459652Sjkh *	Set the key field of the structure to FM_PATCH. The device field is used to
460652Sjkh *	route the patch to the corresponding device.
461652Sjkh *
462652Sjkh *	For Gravis UltraSound use struct patch_info. Initialize the key field
463652Sjkh *      to GUS_PATCH.
464652Sjkh */
465652Sjkh#define SEQ_PRIVATE		0xfe	/* Low level HW dependent events (8 bytes) */
4663256Sswallace#define SEQ_EXTENDED		0xff	/* Extended events (8 bytes) OBSOLETE */
467652Sjkh
468652Sjkh/*
469652Sjkh * Record for FM patches
470652Sjkh */
471652Sjkh
472652Sjkhtypedef unsigned char sbi_instr_data[32];
473652Sjkh
474652Sjkhstruct sbi_instrument {
475652Sjkh		unsigned short	key;		/* 	Initialize to FM_PATCH or OPL3_PATCH */
476652Sjkh#define FM_PATCH	0x01fd
477652Sjkh#define OPL3_PATCH	0x03fd
478652Sjkh		short		device;		/*	Synth# (0-4)	*/
479652Sjkh		int 		channel;	/*	Program# to be initialized 	*/
480652Sjkh		sbi_instr_data	operators;	/*	Register settings for operator cells (.SBI format)	*/
481652Sjkh	};
482652Sjkh
483652Sjkhstruct synth_info {	/* Read only */
484652Sjkh		char	name[30];
485652Sjkh		int	device;		/* 0-N. INITIALIZE BEFORE CALLING */
486652Sjkh		int	synth_type;
487652Sjkh#define SYNTH_TYPE_FM			0
488652Sjkh#define SYNTH_TYPE_SAMPLE		1
4893256Sswallace#define SYNTH_TYPE_MIDI			2	/* Midi interface */
490652Sjkh
491652Sjkh		int	synth_subtype;
492652Sjkh#define FM_TYPE_ADLIB			0x00
493652Sjkh#define FM_TYPE_OPL3			0x01
494652Sjkh
495652Sjkh#define SAMPLE_TYPE_GUS			0x10
496652Sjkh
497652Sjkh		int	perc_mode;	/* No longer supported */
498652Sjkh		int	nr_voices;
499652Sjkh		int	nr_drums;	/* Obsolete field */
500652Sjkh		int	instr_bank_size;
5019750Sjkh		unsigned long	capabilities;
502652Sjkh#define SYNTH_CAP_PERCMODE		0x00000001 /* No longer used */
503652Sjkh#define SYNTH_CAP_OPL3			0x00000002 /* Set if OPL3 supported */
5043256Sswallace#define SYNTH_CAP_INPUT			0x00000004 /* Input (MIDI) device */
505652Sjkh		int	dummies[19];	/* Reserve space */
506652Sjkh	};
507652Sjkh
5083256Sswallacestruct sound_timer_info {
5093256Sswallace		char name[30];
5103256Sswallace		int caps;
5113256Sswallace	};
5123256Sswallace
5133256Sswallace#define MIDI_CAP_MPU401		1		/* MPU-401 intelligent mode */
5143256Sswallace
515652Sjkhstruct midi_info {
516652Sjkh		char		name[30];
517652Sjkh		int		device;		/* 0-N. INITIALIZE BEFORE CALLING */
518652Sjkh		unsigned long	capabilities;	/* To be defined later */
5191258Sswallace		int		dev_type;
5201258Sswallace		int		dummies[18];	/* Reserve space */
521652Sjkh	};
522652Sjkh
523652Sjkh/********************************************
5243256Sswallace * ioctl commands for the /dev/midi##
5253256Sswallace */
5263256Sswallacetypedef struct {
5273256Sswallace		unsigned char cmd;
5283256Sswallace		char nr_args, nr_returns;
5293256Sswallace		unsigned char data[30];
5303256Sswallace	} mpu_command_rec;
5313256Sswallace
5323256Sswallace#define SNDCTL_MIDI_PRETIME		_IOWR('m', 0, int)
5333256Sswallace#define SNDCTL_MIDI_MPUMODE		_IOWR('m', 1, int)
5343256Sswallace#define SNDCTL_MIDI_MPUCMD		_IOWR('m', 2, mpu_command_rec)
5353256Sswallace
5363256Sswallace/********************************************
537652Sjkh * IOCTL commands for /dev/dsp and /dev/audio
538652Sjkh */
539652Sjkh
540652Sjkh#define SNDCTL_DSP_RESET		_IO  ('P', 0)
541652Sjkh#define SNDCTL_DSP_SYNC			_IO  ('P', 1)
542652Sjkh#define SNDCTL_DSP_SPEED		_IOWR('P', 2, int)
543652Sjkh#define SNDCTL_DSP_STEREO		_IOWR('P', 3, int)
5446347Sjkh#define SNDCTL_DSP_GETBLKSIZE		_IOR('P', 4, int)
5459750Sjkh#define SNDCTL_DSP_SETBLKSIZE		_IOW('P', 4, int)
5463256Sswallace#define SNDCTL_DSP_SAMPLESIZE		SNDCTL_DSP_SETFMT
547652Sjkh#define SOUND_PCM_WRITE_CHANNELS	_IOWR('P', 6, int)
548652Sjkh#define SOUND_PCM_WRITE_FILTER		_IOWR('P', 7, int)
549652Sjkh#define SNDCTL_DSP_POST			_IO  ('P', 8)
5501258Sswallace#define SNDCTL_DSP_SUBDIVIDE		_IOWR('P', 9, int)
5513256Sswallace#define SNDCTL_DSP_SETFRAGMENT		_IOWR('P',10, int)
552652Sjkh
5533256Sswallace/*	Audio data formats (Note! U8=8 and S16_LE=16 for compatibility) */
5543256Sswallace#define SNDCTL_DSP_GETFMTS		_IOR ('P',11, int) /* Returns a mask */
5553256Sswallace#define SNDCTL_DSP_SETFMT		_IOWR('P',5, int) /* Selects ONE fmt*/
5563256Sswallace#	define AFMT_QUERY		0x00000000	/* Return current fmt */
5573256Sswallace#	define AFMT_MU_LAW		0x00000001
5583256Sswallace#	define AFMT_A_LAW		0x00000002
5593256Sswallace#	define AFMT_IMA_ADPCM		0x00000004
5603256Sswallace#	define AFMT_U8			0x00000008
5613256Sswallace#	define AFMT_S16_LE		0x00000010	/* Little endian signed 16*/
5623256Sswallace#	define AFMT_S16_BE		0x00000020	/* Big endian signed 16 */
5633256Sswallace#	define AFMT_S8			0x00000040
5643256Sswallace#	define AFMT_U16_LE		0x00000080	/* Little endian U16 */
5653256Sswallace#	define AFMT_U16_BE		0x00000100	/* Big endian U16 */
5669750Sjkh#	define AFMT_MPEG		0x00000200	/* MPEG (2) audio */
5673256Sswallace
5689750Sjkh/*
5699750Sjkh * Buffer status queries.
5709750Sjkh */
5719750Sjkhtypedef struct audio_buf_info {
5729750Sjkh			int fragments;	/* # of available fragments (partially usend ones not counted) */
5739750Sjkh			int fragsize;	/* Size of a fragment in bytes */
5749750Sjkh
5759750Sjkh			int bytes;	/* Available space in bytes (includes partially used fragments) */
5769750Sjkh			/* Note! 'bytes' could be more than fragments*fragsize */
5779750Sjkh		} audio_buf_info;
5789750Sjkh
5799750Sjkh#define SNDCTL_DSP_GETOSPACE		_IOR ('P',12, audio_buf_info)
5809750Sjkh#define SNDCTL_DSP_GETISPACE		_IOR ('P',13, audio_buf_info)
5819750Sjkh#define SNDCTL_DSP_NONBLOCK		_IO  ('P',14)
5829750Sjkh
583652Sjkh#define SOUND_PCM_READ_RATE		_IOR ('P', 2, int)
584652Sjkh#define SOUND_PCM_READ_CHANNELS		_IOR ('P', 6, int)
585652Sjkh#define SOUND_PCM_READ_BITS		_IOR ('P', 5, int)
586652Sjkh#define SOUND_PCM_READ_FILTER		_IOR ('P', 7, int)
587652Sjkh
588652Sjkh/* Some alias names */
5893256Sswallace#define SOUND_PCM_WRITE_BITS		SNDCTL_DSP_SETFMT
590652Sjkh#define SOUND_PCM_WRITE_RATE		SNDCTL_DSP_SPEED
591652Sjkh#define SOUND_PCM_POST			SNDCTL_DSP_POST
592652Sjkh#define SOUND_PCM_RESET			SNDCTL_DSP_RESET
593652Sjkh#define SOUND_PCM_SYNC			SNDCTL_DSP_SYNC
5941258Sswallace#define SOUND_PCM_SUBDIVIDE		SNDCTL_DSP_SUBDIVIDE
5953256Sswallace#define SOUND_PCM_SETFRAGMENT		SNDCTL_DSP_SETFRAGMENT
5963256Sswallace#define SOUND_PCM_GETFMTS		SNDCTL_DSP_GETFMTS
5973256Sswallace#define SOUND_PCM_SETFMT		SNDCTL_DSP_SETFMT
5989750Sjkh#define SOUND_PCM_GETOSPACE		SNDCTL_DSP_GETOSPACE
5999750Sjkh#define SOUND_PCM_GETISPACE		SNDCTL_DSP_GETISPACE
6009750Sjkh#define SOUND_PCM_NONBLOCK		SNDCTL_DSP_NONBLOCK
601652Sjkh
6029750Sjkh/*
6039750Sjkh * ioctl calls to be used in communication with coprocessors and
6049750Sjkh * DSP chips.
6053256Sswallace */
6063256Sswallace
6079750Sjkhtypedef struct copr_buffer {
6089750Sjkh		int command;	/* Set to 0 if not used */
6099750Sjkh		int flags;
6109750Sjkh#define CPF_NONE		0x0000
6119750Sjkh#define CPF_FIRST		0x0001	/* First block */
6129750Sjkh#define CPF_LAST		0x0002	/* Last block */
6139750Sjkh		int len;
6149750Sjkh		int offs;	/* If required by the device (0 if not used) */
6153256Sswallace
6169750Sjkh		unsigned char data[4000]; /* NOTE! 4000 is not 4k */
6179750Sjkh	} copr_buffer;
6189750Sjkh
6199750Sjkhtypedef struct copr_debug_buf {
6209750Sjkh		int command;	/* Used internally. Set to 0 */
6219750Sjkh		int parm1;
6229750Sjkh		int parm2;
6239750Sjkh		int flags;
6249750Sjkh		int len;	/* Length of data in bytes */
6259750Sjkh	} copr_debug_buf;
6269750Sjkh
6279750Sjkhtypedef struct copr_msg {
6289750Sjkh		int len;
6299750Sjkh		unsigned char data[4000];
6309750Sjkh	} copr_msg;
6319750Sjkh
6329750Sjkh#define SNDCTL_COPR_RESET             _IO  ('C',  0)
6339750Sjkh#define SNDCTL_COPR_LOAD	      _IOWR('C',  1, copr_buffer)
6349750Sjkh#define SNDCTL_COPR_RDATA	      _IOWR('C',  2, copr_debug_buf)
6359750Sjkh#define SNDCTL_COPR_RCODE	      _IOWR('C',  3, copr_debug_buf)
6369750Sjkh#define SNDCTL_COPR_WDATA	      _IOW ('C',  4, copr_debug_buf)
6379750Sjkh#define SNDCTL_COPR_WCODE	      _IOW ('C',  5, copr_debug_buf)
6389750Sjkh#define SNDCTL_COPR_RUN		      _IOWR('C',  6, copr_debug_buf)
6399750Sjkh#define SNDCTL_COPR_HALT	      _IOWR('C',  7, copr_debug_buf)
6409750Sjkh#define SNDCTL_COPR_SENDMSG	      _IOW ('C',  8, copr_msg)
6419750Sjkh#define SNDCTL_COPR_RCVMSG	      _IOR ('C',  9, copr_msg)
6429750Sjkh
6433256Sswallace/*********************************************
644652Sjkh * IOCTL commands for /dev/mixer
645652Sjkh */
6469750Sjkh
6479750Sjkh/*
648652Sjkh * Mixer devices
649652Sjkh *
650652Sjkh * There can be up to 20 different analog mixer channels. The
6519750Sjkh * SOUND_MIXER_NRDEVICES gives the currently supported maximum.
652652Sjkh * The SOUND_MIXER_READ_DEVMASK returns a bitmask which tells
653652Sjkh * the devices supported by the particular mixer.
654652Sjkh */
655652Sjkh
6569750Sjkh#define SOUND_MIXER_NRDEVICES	17
657652Sjkh#define SOUND_MIXER_VOLUME	0
658652Sjkh#define SOUND_MIXER_BASS	1
659652Sjkh#define SOUND_MIXER_TREBLE	2
660652Sjkh#define SOUND_MIXER_SYNTH	3
661652Sjkh#define SOUND_MIXER_PCM		4
662652Sjkh#define SOUND_MIXER_SPEAKER	5
663652Sjkh#define SOUND_MIXER_LINE	6
664652Sjkh#define SOUND_MIXER_MIC		7
665652Sjkh#define SOUND_MIXER_CD		8
666652Sjkh#define SOUND_MIXER_IMIX	9	/*  Recording monitor  */
667652Sjkh#define SOUND_MIXER_ALTPCM	10
668652Sjkh#define SOUND_MIXER_RECLEV	11	/* Recording level */
6699750Sjkh#define SOUND_MIXER_IGAIN	12	/* Input gain */
6709750Sjkh#define SOUND_MIXER_OGAIN	13	/* Output gain */
6719750Sjkh/*
6729750Sjkh * The AD1848 codec and compatibles have three line level inputs
6739750Sjkh * (line, aux1 and aux2). Since each card manufacturer have assigned
6749750Sjkh * different meanings to these inputs, it's inpractical to assign
6759750Sjkh * specific meanings (line, cd, synth etc.) to them.
6769750Sjkh */
6779750Sjkh#define SOUND_MIXER_LINE1	14	/* Input source 1  (aux1) */
6789750Sjkh#define SOUND_MIXER_LINE2	15	/* Input source 2  (aux2) */
6799750Sjkh#define SOUND_MIXER_LINE3	16	/* Input source 3  (line) */
680652Sjkh
681652Sjkh/* Some on/off settings (SOUND_SPECIAL_MIN - SOUND_SPECIAL_MAX) */
682652Sjkh/* Not counted to SOUND_MIXER_NRDEVICES, but use the same number space */
683652Sjkh#define SOUND_ONOFF_MIN		28
684652Sjkh#define SOUND_ONOFF_MAX		30
685652Sjkh#define SOUND_MIXER_MUTE	28	/* 0 or 1 */
686652Sjkh#define SOUND_MIXER_ENHANCE	29	/* Enhanced stereo (0, 40, 60 or 80) */
687652Sjkh#define SOUND_MIXER_LOUD	30	/* 0 or 1 */
688652Sjkh
689652Sjkh/* Note!	Number 31 cannot be used since the sign bit is reserved */
690652Sjkh
691652Sjkh#define SOUND_DEVICE_LABELS	{"Vol  ", "Bass ", "Trebl", "Synth", "Pcm  ", "Spkr ", "Line ", \
6929750Sjkh				 "Mic  ", "CD   ", "Mix  ", "Pcm2 ", "Rec  ", "IGain", "OGain", \
6939750Sjkh				 "Line1", "Line2", "Line3"}
694652Sjkh
695652Sjkh#define SOUND_DEVICE_NAMES	{"vol", "bass", "treble", "synth", "pcm", "speaker", "line", \
6969750Sjkh				 "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain", \
6979750Sjkh				 "line1", "line2", "line3"}
698652Sjkh
699652Sjkh/*	Device bitmask identifiers	*/
700652Sjkh
701652Sjkh#define SOUND_MIXER_RECSRC	0xff	/* Arg contains a bit for each recording source */
702652Sjkh#define SOUND_MIXER_DEVMASK	0xfe	/* Arg contains a bit for each supported device */
703652Sjkh#define SOUND_MIXER_RECMASK	0xfd	/* Arg contains a bit for each supported recording source */
704652Sjkh#define SOUND_MIXER_CAPS	0xfc
705652Sjkh	#define SOUND_CAP_EXCL_INPUT	0x00000001	/* Only one recording source at a time */
706652Sjkh#define SOUND_MIXER_STEREODEVS	0xfb	/* Mixer channels supporting stereo */
707652Sjkh
708652Sjkh/*	Device mask bits	*/
709652Sjkh
710652Sjkh#define SOUND_MASK_VOLUME	(1 << SOUND_MIXER_VOLUME)
711652Sjkh#define SOUND_MASK_BASS		(1 << SOUND_MIXER_BASS)
712652Sjkh#define SOUND_MASK_TREBLE	(1 << SOUND_MIXER_TREBLE)
713652Sjkh#define SOUND_MASK_SYNTH	(1 << SOUND_MIXER_SYNTH)
714652Sjkh#define SOUND_MASK_PCM		(1 << SOUND_MIXER_PCM)
715652Sjkh#define SOUND_MASK_SPEAKER	(1 << SOUND_MIXER_SPEAKER)
716652Sjkh#define SOUND_MASK_LINE		(1 << SOUND_MIXER_LINE)
717652Sjkh#define SOUND_MASK_MIC		(1 << SOUND_MIXER_MIC)
718652Sjkh#define SOUND_MASK_CD		(1 << SOUND_MIXER_CD)
719652Sjkh#define SOUND_MASK_IMIX		(1 << SOUND_MIXER_IMIX)
720652Sjkh#define SOUND_MASK_ALTPCM	(1 << SOUND_MIXER_ALTPCM)
721652Sjkh#define SOUND_MASK_RECLEV	(1 << SOUND_MIXER_RECLEV)
7229750Sjkh#define SOUND_MASK_IGAIN	(1 << SOUND_MIXER_IGAIN)
7239750Sjkh#define SOUND_MASK_OGAIN	(1 << SOUND_MIXER_OGAIN)
7249750Sjkh#define SOUND_MASK_LINE1	(1 << SOUND_MIXER_LINE1)
7259750Sjkh#define SOUND_MASK_LINE2	(1 << SOUND_MIXER_LINE2)
7269750Sjkh#define SOUND_MASK_LINE3	(1 << SOUND_MIXER_LINE3)
727652Sjkh
728652Sjkh#define SOUND_MASK_MUTE		(1 << SOUND_MIXER_MUTE)
729652Sjkh#define SOUND_MASK_ENHANCE	(1 << SOUND_MIXER_ENHANCE)
730652Sjkh#define SOUND_MASK_LOUD		(1 << SOUND_MIXER_LOUD)
731652Sjkh
732652Sjkh#define MIXER_READ(dev)		_IOR('M', dev, int)
733652Sjkh#define SOUND_MIXER_READ_VOLUME		MIXER_READ(SOUND_MIXER_VOLUME)
734652Sjkh#define SOUND_MIXER_READ_BASS		MIXER_READ(SOUND_MIXER_BASS)
735652Sjkh#define SOUND_MIXER_READ_TREBLE		MIXER_READ(SOUND_MIXER_TREBLE)
736652Sjkh#define SOUND_MIXER_READ_SYNTH		MIXER_READ(SOUND_MIXER_SYNTH)
737652Sjkh#define SOUND_MIXER_READ_PCM		MIXER_READ(SOUND_MIXER_PCM)
738652Sjkh#define SOUND_MIXER_READ_SPEAKER	MIXER_READ(SOUND_MIXER_SPEAKER)
739652Sjkh#define SOUND_MIXER_READ_LINE		MIXER_READ(SOUND_MIXER_LINE)
740652Sjkh#define SOUND_MIXER_READ_MIC		MIXER_READ(SOUND_MIXER_MIC)
741652Sjkh#define SOUND_MIXER_READ_CD		MIXER_READ(SOUND_MIXER_CD)
742652Sjkh#define SOUND_MIXER_READ_IMIX		MIXER_READ(SOUND_MIXER_IMIX)
743652Sjkh#define SOUND_MIXER_READ_ALTPCM		MIXER_READ(SOUND_MIXER_ALTPCM)
744652Sjkh#define SOUND_MIXER_READ_RECLEV		MIXER_READ(SOUND_MIXER_RECLEV)
7459750Sjkh#define SOUND_MIXER_READ_IGAIN		MIXER_READ(SOUND_MIXER_IGAIN)
7469750Sjkh#define SOUND_MIXER_READ_OGAIN		MIXER_READ(SOUND_MIXER_OGAIN)
7479750Sjkh#define SOUND_MIXER_READ_LINE1		MIXER_READ(SOUND_MIXER_LINE1)
7489750Sjkh#define SOUND_MIXER_READ_LINE2		MIXER_READ(SOUND_MIXER_LINE2)
7499750Sjkh#define SOUND_MIXER_READ_LINE3		MIXER_READ(SOUND_MIXER_LINE3)
750652Sjkh#define SOUND_MIXER_READ_MUTE		MIXER_READ(SOUND_MIXER_MUTE)
751652Sjkh#define SOUND_MIXER_READ_ENHANCE	MIXER_READ(SOUND_MIXER_ENHANCE)
752652Sjkh#define SOUND_MIXER_READ_LOUD		MIXER_READ(SOUND_MIXER_LOUD)
753652Sjkh
754652Sjkh#define SOUND_MIXER_READ_RECSRC		MIXER_READ(SOUND_MIXER_RECSRC)
755652Sjkh#define SOUND_MIXER_READ_DEVMASK	MIXER_READ(SOUND_MIXER_DEVMASK)
756652Sjkh#define SOUND_MIXER_READ_RECMASK	MIXER_READ(SOUND_MIXER_RECMASK)
757652Sjkh#define SOUND_MIXER_READ_STEREODEVS	MIXER_READ(SOUND_MIXER_STEREODEVS)
758652Sjkh#define SOUND_MIXER_READ_CAPS		MIXER_READ(SOUND_MIXER_CAPS)
759652Sjkh
760652Sjkh#define MIXER_WRITE(dev)		_IOWR('M', dev, int)
761652Sjkh#define SOUND_MIXER_WRITE_VOLUME	MIXER_WRITE(SOUND_MIXER_VOLUME)
762652Sjkh#define SOUND_MIXER_WRITE_BASS		MIXER_WRITE(SOUND_MIXER_BASS)
763652Sjkh#define SOUND_MIXER_WRITE_TREBLE	MIXER_WRITE(SOUND_MIXER_TREBLE)
764652Sjkh#define SOUND_MIXER_WRITE_SYNTH		MIXER_WRITE(SOUND_MIXER_SYNTH)
765652Sjkh#define SOUND_MIXER_WRITE_PCM		MIXER_WRITE(SOUND_MIXER_PCM)
766652Sjkh#define SOUND_MIXER_WRITE_SPEAKER	MIXER_WRITE(SOUND_MIXER_SPEAKER)
767652Sjkh#define SOUND_MIXER_WRITE_LINE		MIXER_WRITE(SOUND_MIXER_LINE)
768652Sjkh#define SOUND_MIXER_WRITE_MIC		MIXER_WRITE(SOUND_MIXER_MIC)
769652Sjkh#define SOUND_MIXER_WRITE_CD		MIXER_WRITE(SOUND_MIXER_CD)
770652Sjkh#define SOUND_MIXER_WRITE_IMIX		MIXER_WRITE(SOUND_MIXER_IMIX)
771652Sjkh#define SOUND_MIXER_WRITE_ALTPCM	MIXER_WRITE(SOUND_MIXER_ALTPCM)
772652Sjkh#define SOUND_MIXER_WRITE_RECLEV	MIXER_WRITE(SOUND_MIXER_RECLEV)
7739750Sjkh#define SOUND_MIXER_WRITE_IGAIN		MIXER_WRITE(SOUND_MIXER_IGAIN)
7749750Sjkh#define SOUND_MIXER_WRITE_OGAIN		MIXER_WRITE(SOUND_MIXER_OGAIN)
7759750Sjkh#define SOUND_MIXER_WRITE_LINE1		MIXER_WRITE(SOUND_MIXER_LINE1)
7769750Sjkh#define SOUND_MIXER_WRITE_LINE2		MIXER_WRITE(SOUND_MIXER_LINE2)
7779750Sjkh#define SOUND_MIXER_WRITE_LINE3		MIXER_WRITE(SOUND_MIXER_LINE3)
778652Sjkh#define SOUND_MIXER_WRITE_MUTE		MIXER_WRITE(SOUND_MIXER_MUTE)
779652Sjkh#define SOUND_MIXER_WRITE_ENHANCE	MIXER_WRITE(SOUND_MIXER_ENHANCE)
780652Sjkh#define SOUND_MIXER_WRITE_LOUD		MIXER_WRITE(SOUND_MIXER_LOUD)
781652Sjkh
782652Sjkh#define SOUND_MIXER_WRITE_RECSRC	MIXER_WRITE(SOUND_MIXER_RECSRC)
783652Sjkh
784652Sjkh/*
7853256Sswallace * Level 2 event types for /dev/sequencer
7863256Sswallace */
7873256Sswallace
7883256Sswallace/*
7893256Sswallace * The 4 most significant bits of byte 0 specify the class of
7909750Sjkh * the event:
791652Sjkh *
7923256Sswallace *	0x8X = system level events,
7933256Sswallace *	0x9X = device/port specific events, event[1] = device/port,
7943256Sswallace *		The last 4 bits give the subtype:
7953256Sswallace *			0x02	= Channel event (event[3] = chn).
7963256Sswallace *			0x01	= note event (event[4] = note).
7973256Sswallace *			(0x01 is not used alone but always with bit 0x02).
7983256Sswallace *	       event[2] = MIDI message code (0x80=note off etc.)
7993256Sswallace *
800652Sjkh */
801652Sjkh
8023256Sswallace#define EV_SEQ_LOCAL		0x80
8033256Sswallace#define EV_TIMING		0x81
8043256Sswallace#define EV_CHN_COMMON		0x92
8053256Sswallace#define EV_CHN_VOICE		0x93
8063256Sswallace/*
8073256Sswallace * Event types 200 to 220 are reserved for application use.
8083256Sswallace * These numbers will not be used by the driver.
8093256Sswallace */
810652Sjkh
811652Sjkh/*
8123256Sswallace * Events for event type EV_CHN_VOICE
813652Sjkh */
814652Sjkh
8153256Sswallace#define MIDI_NOTEOFF		0x80
8163256Sswallace#define MIDI_NOTEON		0x90
8173256Sswallace#define MIDI_KEY_PRESSURE	0xA0
8183256Sswallace
819652Sjkh/*
8203256Sswallace * Events for event type EV_CHN_COMMON
821652Sjkh */
822652Sjkh
8233256Sswallace#define MIDI_CTL_CHANGE		0xB0
8243256Sswallace#define MIDI_PGM_CHANGE		0xC0
8253256Sswallace#define MIDI_CHN_PRESSURE	0xD0
8263256Sswallace#define MIDI_PITCH_BEND		0xE0
827652Sjkh
8283256Sswallace#define MIDI_SYSTEM_PREFIX	0xF0
8293256Sswallace
830652Sjkh/*
8313256Sswallace * Timer event types
8323256Sswallace */
8333256Sswallace#define TMR_WAIT_REL		1	/* Time relative to the prev time */
8343256Sswallace#define TMR_WAIT_ABS		2	/* Absolute time since TMR_START */
8353256Sswallace#define TMR_STOP		3
8363256Sswallace#define TMR_START		4
8373256Sswallace#define TMR_CONTINUE		5
8383256Sswallace#define TMR_TEMPO		6
8393256Sswallace#define TMR_ECHO		8
8403256Sswallace#define TMR_CLOCK		9	/* MIDI clock */
8413256Sswallace#define TMR_SPP			10	/* Song position pointer */
8423256Sswallace#define TMR_TIMESIG		11	/* Time signature */
8433256Sswallace
8449750Sjkh#if (!defined(__KERNEL__) && !defined(KERNEL) && !defined(INKERNEL) && !defined(_KERNEL)) || defined(USE_SEQ_MACROS)
8453256Sswallace/*
846652Sjkh *	Some convenience macros to simplify programming of the
847652Sjkh *	/dev/sequencer interface
848652Sjkh *
849652Sjkh *	These macros define the API which should be used when possible.
850652Sjkh */
851652Sjkh
8523256Sswallace#ifndef USE_SIMPLE_MACROS
853805Sachevoid seqbuf_dump(void);	/* This function must be provided by programs */
854652Sjkh
855652Sjkh/* Sample seqbuf_dump() implementation:
856652Sjkh *
857652Sjkh *	SEQ_DEFINEBUF (2048);	-- Defines a buffer for 2048 bytes
858652Sjkh *
859652Sjkh *	int seqfd;		-- The file descriptor for /dev/sequencer.
860652Sjkh *
861652Sjkh *	void
862652Sjkh *	seqbuf_dump ()
863652Sjkh *	{
864652Sjkh *	  if (_seqbufptr)
865652Sjkh *	    if (write (seqfd, _seqbuf, _seqbufptr) == -1)
866652Sjkh *	      {
867652Sjkh *		perror ("write /dev/sequencer");
868652Sjkh *		exit (-1);
869652Sjkh *	      }
870652Sjkh *	  _seqbufptr = 0;
871652Sjkh *	}
872652Sjkh */
873652Sjkh
8743256Sswallace#define SEQ_DEFINEBUF(len)		unsigned char _seqbuf[len]; int _seqbuflen = len;int _seqbufptr = 0
8753256Sswallace#define SEQ_USE_EXTBUF()		extern unsigned char _seqbuf[]; extern int _seqbuflen;extern int _seqbufptr
8763256Sswallace#define SEQ_DECLAREBUF()		SEQ_USE_EXTBUF()
877652Sjkh#define SEQ_PM_DEFINES			struct patmgr_info _pm_info
878652Sjkh#define _SEQ_NEEDBUF(len)		if ((_seqbufptr+(len)) > _seqbuflen) seqbuf_dump()
879652Sjkh#define _SEQ_ADVBUF(len)		_seqbufptr += len
880652Sjkh#define SEQ_DUMPBUF			seqbuf_dump
8813256Sswallace#else
8823256Sswallace/*
8833256Sswallace * This variation of the sequencer macros is used just to format one event
8843256Sswallace * using fixed buffer.
8859750Sjkh *
8863256Sswallace * The program using the macro library must define the following macros before
8873256Sswallace * using this library.
8883256Sswallace *
8899750Sjkh * #define _seqbuf 		 name of the buffer (unsigned char[])
8903256Sswallace * #define _SEQ_ADVBUF(len)	 If the applic needs to know the exact
8913256Sswallace *				 size of the event, this macro can be used.
8923256Sswallace *				 Otherwise this must be defined as empty.
8933256Sswallace * #define _seqbufptr		 Define the name of index variable or 0 if
8949750Sjkh *				 not required.
8953256Sswallace */
8963256Sswallace#define _SEQ_NEEDBUF(len)	/* empty */
8973256Sswallace#endif
8983256Sswallace
899652Sjkh#define PM_LOAD_PATCH(dev, bank, pgm)	(SEQ_DUMPBUF(), _pm_info.command = _PM_LOAD_PATCH, \
900652Sjkh					_pm_info.device=dev, _pm_info.data.data8[0]=pgm, \
901652Sjkh					_pm_info.parm1 = bank, _pm_info.parm2 = 1, \
902652Sjkh					ioctl(seqfd, SNDCTL_PMGR_ACCESS, &_pm_info))
903652Sjkh#define PM_LOAD_PATCHES(dev, bank, pgm) (SEQ_DUMPBUF(), _pm_info.command = _PM_LOAD_PATCH, \
904652Sjkh					_pm_info.device=dev, memcpy(_pm_info.data.data8, pgm, 128), \
905652Sjkh					_pm_info.parm1 = bank, _pm_info.parm2 = 128, \
906652Sjkh					ioctl(seqfd, SNDCTL_PMGR_ACCESS, &_pm_info))
907652Sjkh
9081402Sache#define SEQ_VOLUME_MODE(dev, mode)	{_SEQ_NEEDBUF(8);\
9091402Sache					_seqbuf[_seqbufptr] = SEQ_EXTENDED;\
9101402Sache					_seqbuf[_seqbufptr+1] = SEQ_VOLMODE;\
9111402Sache					_seqbuf[_seqbufptr+2] = (dev);\
9121402Sache					_seqbuf[_seqbufptr+3] = (mode);\
9131402Sache					_seqbuf[_seqbufptr+4] = 0;\
9141402Sache					_seqbuf[_seqbufptr+5] = 0;\
9151402Sache					_seqbuf[_seqbufptr+6] = 0;\
9161402Sache					_seqbuf[_seqbufptr+7] = 0;\
9171402Sache					_SEQ_ADVBUF(8);}
9181402Sache
9193256Sswallace/*
9203256Sswallace * Midi voice messages
9213256Sswallace */
922652Sjkh
9233256Sswallace#define _CHN_VOICE(dev, event, chn, note, parm) \
9243256Sswallace					{_SEQ_NEEDBUF(8);\
9253256Sswallace					_seqbuf[_seqbufptr] = EV_CHN_VOICE;\
9263256Sswallace					_seqbuf[_seqbufptr+1] = (dev);\
9273256Sswallace					_seqbuf[_seqbufptr+2] = (event);\
9283256Sswallace					_seqbuf[_seqbufptr+3] = (chn);\
929652Sjkh					_seqbuf[_seqbufptr+4] = (note);\
9303256Sswallace					_seqbuf[_seqbufptr+5] = (parm);\
9313256Sswallace					_seqbuf[_seqbufptr+6] = (0);\
932652Sjkh					_seqbuf[_seqbufptr+7] = 0;\
933652Sjkh					_SEQ_ADVBUF(8);}
934652Sjkh
9353256Sswallace#define SEQ_START_NOTE(dev, chn, note, vol) \
9363256Sswallace		_CHN_VOICE(dev, MIDI_NOTEON, chn, note, vol)
9373256Sswallace
9383256Sswallace#define SEQ_STOP_NOTE(dev, chn, note, vol) \
9393256Sswallace		_CHN_VOICE(dev, MIDI_NOTEOFF, chn, note, vol)
9403256Sswallace
9413256Sswallace#define SEQ_KEY_PRESSURE(dev, chn, note, pressure) \
9423256Sswallace		_CHN_VOICE(dev, MIDI_KEY_PRESSURE, chn, note, pressure)
9433256Sswallace
9443256Sswallace/*
9453256Sswallace * Midi channel messages
9463256Sswallace */
9473256Sswallace
9483256Sswallace#define _CHN_COMMON(dev, event, chn, p1, p2, w14) \
9493256Sswallace					{_SEQ_NEEDBUF(8);\
9503256Sswallace					_seqbuf[_seqbufptr] = EV_CHN_COMMON;\
9513256Sswallace					_seqbuf[_seqbufptr+1] = (dev);\
9523256Sswallace					_seqbuf[_seqbufptr+2] = (event);\
9533256Sswallace					_seqbuf[_seqbufptr+3] = (chn);\
9543256Sswallace					_seqbuf[_seqbufptr+4] = (p1);\
9553256Sswallace					_seqbuf[_seqbufptr+5] = (p2);\
9563256Sswallace					*(short *)&_seqbuf[_seqbufptr+6] = (w14);\
957652Sjkh					_SEQ_ADVBUF(8);}
958652Sjkh
9593256Sswallace#define SEQ_CHN_PRESSURE(dev, chn, pressure) \
9603256Sswallace		_CHN_COMMON(dev, MIDI_CHN_PRESSURE, chn, pressure, 0, 0)
9613256Sswallace
9623256Sswallace#define SEQ_SET_PATCH(dev, chn, patch) \
9633256Sswallace		_CHN_COMMON(dev, MIDI_PGM_CHANGE, chn, patch, 0, 0)
9643256Sswallace
9653256Sswallace#define SEQ_CONTROL(dev, chn, controller, value) \
9663256Sswallace		_CHN_COMMON(dev, MIDI_CTL_CHANGE, chn, controller, 0, value)
9673256Sswallace
9683256Sswallace#define SEQ_BENDER(dev, chn, value) \
9693256Sswallace		_CHN_COMMON(dev, MIDI_PITCH_BEND, chn, 0, 0, value)
9703256Sswallace
9719750Sjkh
9729750Sjkh#define SEQ_V2_X_CONTROL(dev, voice, controller, value)	{_SEQ_NEEDBUF(8);\
9739750Sjkh					_seqbuf[_seqbufptr] = SEQ_EXTENDED;\
9749750Sjkh					_seqbuf[_seqbufptr+1] = SEQ_CONTROLLER;\
9759750Sjkh					_seqbuf[_seqbufptr+2] = (dev);\
9769750Sjkh					_seqbuf[_seqbufptr+3] = (voice);\
9779750Sjkh					_seqbuf[_seqbufptr+4] = (controller);\
9789750Sjkh					*(short *)&_seqbuf[_seqbufptr+5] = (value);\
9799750Sjkh					_seqbuf[_seqbufptr+7] = 0;\
9809750Sjkh					_SEQ_ADVBUF(8);}
9813256Sswallace/*
9823256Sswallace * The following 5 macros are incorrectly implemented and obsolete.
9833256Sswallace * Use SEQ_BENDER and SEQ_CONTROL (with proper controller) instead.
9843256Sswallace */
9859750Sjkh#define SEQ_PITCHBEND(dev, voice, value) SEQ_V2_X_CONTROL(dev, voice, CTRL_PITCH_BENDER, value)
9869750Sjkh#define SEQ_BENDER_RANGE(dev, voice, value) SEQ_V2_X_CONTROL(dev, voice, CTRL_PITCH_BENDER_RANGE, value)
9873256Sswallace#define SEQ_EXPRESSION(dev, voice, value) SEQ_CONTROL(dev, voice, CTL_EXPRESSION, value*128)
9883256Sswallace#define SEQ_MAIN_VOLUME(dev, voice, value) SEQ_CONTROL(dev, voice, CTL_MAIN_VOLUME, (value*16383)/100)
9893256Sswallace#define SEQ_PANNING(dev, voice, pos) SEQ_CONTROL(dev, voice, CTL_PAN, (pos+128) / 2)
9903256Sswallace#if 0
991652Sjkh#define SEQ_PANNING(dev, voice, pos)	{_SEQ_NEEDBUF(8);\
992652Sjkh					_seqbuf[_seqbufptr] = SEQ_EXTENDED;\
993652Sjkh					_seqbuf[_seqbufptr+1] = SEQ_BALANCE;\
994652Sjkh					_seqbuf[_seqbufptr+2] = (dev);\
995652Sjkh					_seqbuf[_seqbufptr+3] = (voice);\
996652Sjkh					(char)_seqbuf[_seqbufptr+4] = (pos);\
997652Sjkh					_seqbuf[_seqbufptr+5] = 0;\
998652Sjkh					_seqbuf[_seqbufptr+6] = 0;\
9993256Sswallace					_seqbuf[_seqbufptr+7] = 1;\
1000652Sjkh					_SEQ_ADVBUF(8);}
10013256Sswallace#endif
1002652Sjkh
10033256Sswallace/*
10043256Sswallace * Timing and syncronization macros
10053256Sswallace */
1006652Sjkh
10073256Sswallace#define _TIMER_EVENT(ev, parm)		{_SEQ_NEEDBUF(8);\
10083256Sswallace				 	_seqbuf[_seqbufptr+0] = EV_TIMING; \
10093256Sswallace				 	_seqbuf[_seqbufptr+1] = (ev); \
1010652Sjkh					_seqbuf[_seqbufptr+2] = 0;\
1011652Sjkh					_seqbuf[_seqbufptr+3] = 0;\
10123256Sswallace				 	*(unsigned int *)&_seqbuf[_seqbufptr+4] = (parm); \
1013652Sjkh					_SEQ_ADVBUF(8);}
1014652Sjkh
10153256Sswallace#define SEQ_START_TIMER()		_TIMER_EVENT(TMR_START, 0)
10163256Sswallace#define SEQ_STOP_TIMER()		_TIMER_EVENT(TMR_STOP, 0)
10173256Sswallace#define SEQ_CONTINUE_TIMER()		_TIMER_EVENT(TMR_CONTINUE, 0)
10183256Sswallace#define SEQ_WAIT_TIME(ticks)		_TIMER_EVENT(TMR_WAIT_ABS, ticks)
10193256Sswallace#define SEQ_DELTA_TIME(ticks)		_TIMER_EVENT(TMR_WAIT_REL, ticks)
10203256Sswallace#define SEQ_ECHO_BACK(key)		_TIMER_EVENT(TMR_ECHO, key)
10213256Sswallace#define SEQ_SET_TEMPO(value)		_TIMER_EVENT(TMR_TEMPO, value)
10223256Sswallace#define SEQ_SONGPOS(pos)		_TIMER_EVENT(TMR_SPP, pos)
10233256Sswallace#define SEQ_TIME_SIGNATURE(sig)		_TIMER_EVENT(TMR_TIMESIG, sig)
1024652Sjkh
10253256Sswallace/*
10269750Sjkh * Events for the level 1 interface only
10273256Sswallace */
1028652Sjkh
1029652Sjkh#define SEQ_MIDIOUT(device, byte)	{_SEQ_NEEDBUF(4);\
1030652Sjkh					_seqbuf[_seqbufptr] = SEQ_MIDIPUTC;\
1031652Sjkh					_seqbuf[_seqbufptr+1] = (byte);\
1032652Sjkh					_seqbuf[_seqbufptr+2] = (device);\
1033652Sjkh					_seqbuf[_seqbufptr+3] = 0;\
1034652Sjkh					_SEQ_ADVBUF(4);}
10353256Sswallace
10363256Sswallace/*
10373256Sswallace * Patch loading.
10383256Sswallace */
10393256Sswallace#define SEQ_WRPATCH(patchx, len)		{if (_seqbufptr) seqbuf_dump();\
10401402Sache					if (write(seqfd, (char*)(patchx), len)==-1) \
1041652Sjkh					   perror("Write patch: /dev/sequencer");}
10423256Sswallace#define SEQ_WRPATCH2(patchx, len)	(seqbuf_dump(), write(seqfd, (char*)(patchx), len))
1043652Sjkh
10449750Sjkh#endif
10459750Sjkh#endif
1046