xref: /freebsd/sys/sys/soundcard.h (revision 05c7a37afb48ddd5ee1bd921a5d46fe59cc70b15)
1 #ifndef SOUNDCARD_H
2 #define SOUNDCARD_H
3 /*
4  * Copyright by Hannu Savolainen 1993
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  *
27  *
28  */
29 
30  /*
31   * If you make modifications to this file, please contact me before
32   * distributing the modified version. There is already enough
33   * diversity in the world.
34   *
35   * Regards,
36   * Hannu Savolainen
37   * hannu@voxware.pp.fi
38   */
39 
40 #define SOUND_VERSION	301
41 #define VOXWARE
42 
43 #include <sys/ioctl.h>
44 
45 /*
46  *	Supported card ID numbers (Should be somewhere else?)
47  */
48 
49 #define SNDCARD_ADLIB		1
50 #define SNDCARD_SB		2
51 #define SNDCARD_PAS		3
52 #define SNDCARD_GUS		4
53 #define SNDCARD_MPU401		5
54 #define SNDCARD_SB16		6
55 #define SNDCARD_SB16MIDI	7
56 #define SNDCARD_UART6850	8
57 #define SNDCARD_GUS16		9
58 #define SNDCARD_MSS		10
59 #define SNDCARD_PSS     	11
60 #define SNDCARD_SSCAPE		12
61 #define SNDCARD_PSS_MPU     	13
62 #define SNDCARD_PSS_MSS     	14
63 #define SNDCARD_SSCAPE_MSS	15
64 #define SNDCARD_TRXPRO		16
65 #define SNDCARD_TRXPRO_SB	17
66 #define SNDCARD_TRXPRO_MPU	18
67 
68 /***********************************
69  * IOCTL Commands for /dev/sequencer
70  */
71 
72 #ifndef _IOWR
73 /*	@(#)ioctlp.h */
74 
75 /* Ioctl's have the command encoded in the lower word,
76  * and the size of any in or out parameters in the upper
77  * word.  The high 2 bits of the upper word are used
78  * to encode the in/out status of the parameter; for now
79  * we restrict parameters to at most 128 bytes.
80  */
81 /* #define	IOCTYPE		(0xff<<8) */
82 #define	IOCPARM_MASK	0x7f		/* parameters must be < 128 bytes */
83 #define	IOC_VOID	0x00000000	/* no parameters */
84 #define	IOC_OUT		0x20000000	/* copy out parameters */
85 #define	IOC_IN		0x40000000	/* copy in parameters */
86 #define	IOC_INOUT	(IOC_IN|IOC_OUT)
87 /* the 0x20000000 is so we can distinguish new ioctl's from old */
88 #define	_IO(x,y)	((int)(IOC_VOID|(x<<8)|y))
89 #define	_IOR(x,y,t)	((int)(IOC_OUT|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
90 #define	_IOW(x,y,t)	((int)(IOC_IN|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
91 /* this should be _IORW, but stdio got there first */
92 #define	_IOWR(x,y,t)	((int)(IOC_INOUT|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
93 #endif  /* !_IOWR */
94 
95 #define SNDCTL_SEQ_RESET		_IO  ('Q', 0)
96 #define SNDCTL_SEQ_SYNC			_IO  ('Q', 1)
97 #define SNDCTL_SYNTH_INFO		_IOWR('Q', 2, struct synth_info)
98 #define SNDCTL_SEQ_CTRLRATE		_IOWR('Q', 3, int)	/* Set/get timer resolution (HZ) */
99 #define SNDCTL_SEQ_GETOUTCOUNT		_IOR ('Q', 4, int)
100 #define SNDCTL_SEQ_GETINCOUNT		_IOR ('Q', 5, int)
101 #define SNDCTL_SEQ_PERCMODE		_IOW ('Q', 6, int)
102 #define SNDCTL_FM_LOAD_INSTR		_IOW ('Q', 7, struct sbi_instrument)	/* Valid for FM only */
103 #define SNDCTL_SEQ_TESTMIDI		_IOW ('Q', 8, int)
104 #define SNDCTL_SEQ_RESETSAMPLES		_IOW ('Q', 9, int)
105 #define SNDCTL_SEQ_NRSYNTHS		_IOR ('Q',10, int)
106 #define SNDCTL_SEQ_NRMIDIS		_IOR ('Q',11, int)
107 #define SNDCTL_MIDI_INFO		_IOWR('Q',12, struct midi_info)
108 #define SNDCTL_SEQ_TRESHOLD		_IOW ('Q',13, int)
109 #define SNDCTL_SYNTH_MEMAVL		_IOWR('Q',14, int)	/* in=dev#, out=memsize */
110 #define SNDCTL_FM_4OP_ENABLE		_IOW ('Q',15, int)	/* in=dev# */
111 #define SNDCTL_PMGR_ACCESS		_IOWR('Q',16, struct patmgr_info)
112 #define SNDCTL_SEQ_PANIC		_IO  ('Q',17)
113 #define SNDCTL_SEQ_OUTOFBAND		_IOW ('Q',18, struct seq_event_rec)
114 
115 	struct seq_event_rec {
116 			unsigned char arr[8];
117 		};
118 
119 #define SNDCTL_TMR_TIMEBASE		_IOWR('T', 1, int)
120 #define SNDCTL_TMR_START		_IO  ('T', 2)
121 #define SNDCTL_TMR_STOP			_IO  ('T', 3)
122 #define SNDCTL_TMR_CONTINUE		_IO  ('T', 4)
123 #define SNDCTL_TMR_TEMPO		_IOWR('T', 5, int)
124 #define SNDCTL_TMR_SOURCE		_IOWR('T', 6, int)
125 #	define TMR_INTERNAL		0x00000001
126 #	define TMR_EXTERNAL		0x00000002
127 #		define TMR_MODE_MIDI	0x00000010
128 #		define TMR_MODE_FSK	0x00000020
129 #		define TMR_MODE_CLS	0x00000040
130 #		define TMR_MODE_SMPTE	0x00000080
131 #define SNDCTL_TMR_METRONOME		_IOW ('T', 7, int)
132 #define SNDCTL_TMR_SELECT		_IOW ('T', 8, int)
133 
134 /*
135  *	Sample loading mechanism for internal synthesizers (/dev/sequencer)
136  *	The following patch_info structure has been designed to support
137  *	Gravis UltraSound. It tries to be universal format for uploading
138  *	sample based patches but is probably too limited.
139  */
140 
141 struct patch_info {
142 		short key;		/* Use GUS_PATCH here */
143 #define GUS_PATCH	0x04fd
144 #define OBSOLETE_GUS_PATCH	0x02fd
145 		short device_no;	/* Synthesizer number */
146 		short instr_no;		/* Midi pgm# */
147 
148 		unsigned long mode;
149 /*
150  * The least significant byte has the same format than the GUS .PAT
151  * files
152  */
153 #define WAVE_16_BITS	0x01	/* bit 0 = 8 or 16 bit wave data. */
154 #define WAVE_UNSIGNED	0x02	/* bit 1 = Signed - Unsigned data. */
155 #define WAVE_LOOPING	0x04	/* bit 2 = looping enabled-1. */
156 #define WAVE_BIDIR_LOOP	0x08	/* bit 3 = Set is bidirectional looping. */
157 #define WAVE_LOOP_BACK	0x10	/* bit 4 = Set is looping backward. */
158 #define WAVE_SUSTAIN_ON	0x20	/* bit 5 = Turn sustaining on. (Env. pts. 3)*/
159 #define WAVE_ENVELOPES	0x40	/* bit 6 = Enable envelopes - 1 */
160 				/* 	(use the env_rate/env_offs fields). */
161 /* Linux specific bits */
162 #define WAVE_VIBRATO	0x00010000	/* The vibrato info is valid */
163 #define WAVE_TREMOLO	0x00020000	/* The tremolo info is valid */
164 #define WAVE_SCALE	0x00040000	/* The scaling info is valid */
165 /* Other bits must be zeroed */
166 
167 		long len;	/* Size of the wave data in bytes */
168 		long loop_start, loop_end; /* Byte offsets from the beginning */
169 
170 /*
171  * The base_freq and base_note fields are used when computing the
172  * playback speed for a note. The base_note defines the tone frequency
173  * which is heard if the sample is played using the base_freq as the
174  * playback speed.
175  *
176  * The low_note and high_note fields define the minimum and maximum note
177  * frequencies for which this sample is valid. It is possible to define
178  * more than one samples for a instrument number at the same time. The
179  * low_note and high_note fields are used to select the most suitable one.
180  *
181  * The fields base_note, high_note and low_note should contain
182  * the note frequency multiplied by 1000. For example value for the
183  * middle A is 440*1000.
184  */
185 
186 		unsigned int base_freq;
187 		unsigned long base_note;
188 		unsigned long high_note;
189 		unsigned long low_note;
190 		int panning;	/* -128=left, 127=right */
191 		int detuning;
192 
193 /*	New fields introduced in version 1.99.5	*/
194 
195        /* Envelope. Enabled by mode bit WAVE_ENVELOPES	*/
196 		unsigned char	env_rate[ 6 ];	 /* GUS HW ramping rate */
197 		unsigned char	env_offset[ 6 ]; /* 255 == 100% */
198 
199 	/*
200 	 * The tremolo, vibrato and scale info are not supported yet.
201 	 * Enable by setting the mode bits WAVE_TREMOLO, WAVE_VIBRATO or
202 	 * WAVE_SCALE
203 	 */
204 
205 		unsigned char	tremolo_sweep;
206 		unsigned char	tremolo_rate;
207 		unsigned char	tremolo_depth;
208 
209 		unsigned char	vibrato_sweep;
210 		unsigned char	vibrato_rate;
211 		unsigned char	vibrato_depth;
212 
213 		int		scale_frequency;
214 		unsigned int	scale_factor;		/* from 0 to 2048 or 0 to 2 */
215 
216 	        int		volume;
217 	        int		spare[4];
218 		char data[1];	/* The waveform data starts here */
219 	};
220 
221 
222 struct sysex_info {
223 		short key;		/* Use GUS_PATCH here */
224 #define SYSEX_PATCH	0x05fd
225 		short device_no;	/* Synthesizer number */
226 		long len;	/* Size of the sysex data in bytes */
227 		unsigned char data[1];	/* Sysex data starts here */
228 	};
229 
230 /*
231  * Patch management interface (/dev/sequencer, /dev/patmgr#)
232  * Don't use these calls if you want to maintain compatibility with
233  * the future versions of the driver.
234  */
235 
236 #define 	PS_NO_PATCHES		0	/* No patch support on device */
237 #define		PS_MGR_NOT_OK		1	/* Plain patch support (no mgr) */
238 #define		PS_MGR_OK		2	/* Patch manager supported */
239 #define		PS_MANAGED		3	/* Patch manager running */
240 
241 #define SNDCTL_PMGR_IFACE		_IOWR('P', 1, struct patmgr_info)
242 
243 /*
244  * The patmgr_info is a fixed size structure which is used for two
245  * different purposes. The intended use is for communication between
246  * the application using /dev/sequencer and the patch manager daemon
247  * associated with a synthesizer device (ioctl(SNDCTL_PMGR_ACCESS)).
248  *
249  * This structure is also used with ioctl(SNDCTL_PGMR_IFACE) which allows
250  * a patch manager daemon to read and write device parameters. This
251  * ioctl available through /dev/sequencer also. Avoid using it since it's
252  * extremely hardware dependent. In addition access trough /dev/sequencer
253  * may confuse the patch manager daemon.
254  */
255 
256 struct patmgr_info {	/* Note! size must be < 4k since kmalloc() is used */
257 	  unsigned long key;	/* Don't worry. Reserved for communication
258 	  			   between the patch manager and the driver. */
259 #define PM_K_EVENT		1 /* Event from the /dev/sequencer driver */
260 #define PM_K_COMMAND		2 /* Request from a application */
261 #define PM_K_RESPONSE		3 /* From patmgr to application */
262 #define PM_ERROR		4 /* Error returned by the patmgr */
263 	  int device;
264 	  int command;
265 
266 /*
267  * Commands 0x000 to 0xfff reserved for patch manager programs
268  */
269 #define PM_GET_DEVTYPE	1	/* Returns type of the patch mgr interface of dev */
270 #define		PMTYPE_FM2	1	/* 2 OP fm */
271 #define		PMTYPE_FM4	2	/* Mixed 4 or 2 op FM (OPL-3) */
272 #define		PMTYPE_WAVE	3	/* Wave table synthesizer (GUS) */
273 #define PM_GET_NRPGM	2	/* Returns max # of midi programs in parm1 */
274 #define PM_GET_PGMMAP	3	/* Returns map of loaded midi programs in data8 */
275 #define PM_GET_PGM_PATCHES 4	/* Return list of patches of a program (parm1) */
276 #define PM_GET_PATCH	5	/* Return patch header of patch parm1 */
277 #define PM_SET_PATCH	6	/* Set patch header of patch parm1 */
278 #define PM_READ_PATCH	7	/* Read patch (wave) data */
279 #define PM_WRITE_PATCH	8	/* Write patch (wave) data */
280 
281 /*
282  * Commands 0x1000 to 0xffff are for communication between the patch manager
283  * and the client
284  */
285 #define _PM_LOAD_PATCH	0x100
286 
287 /*
288  * Commands above 0xffff reserved for device specific use
289  */
290 
291 	  long parm1;
292 	  long parm2;
293 	  long parm3;
294 
295 	  union {
296 		unsigned char data8[4000];
297 		unsigned short data16[2000];
298 		unsigned long data32[1000];
299 		struct patch_info patch;
300 	  } data;
301 	};
302 
303 /*
304  * When a patch manager daemon is present, it will be informed by the
305  * driver when something important happens. For example when the
306  * /dev/sequencer is opened or closed. A record with key == PM_K_EVENT is
307  * returned. The command field contains the event type:
308  */
309 #define PM_E_OPENED		1	/* /dev/sequencer opened */
310 #define PM_E_CLOSED		2	/* /dev/sequencer closed */
311 #define PM_E_PATCH_RESET	3	/* SNDCTL_RESETSAMPLES called */
312 #define PM_E_PATCH_LOADED	4	/* A patch has been loaded by appl */
313 
314 /*
315  * /dev/sequencer input events.
316  *
317  * The data written to the /dev/sequencer is a stream of events. Events
318  * are records of 4 or 8 bytes. The first byte defines the size.
319  * Any number of events can be written with a write call. There
320  * is a set of macros for sending these events. Use these macros if you
321  * want to maximize portability of your program.
322  *
323  * Events SEQ_WAIT, SEQ_MIDIPUTC and SEQ_ECHO. Are also input events.
324  * (All input events are currently 4 bytes long. Be prepared to support
325  * 8 byte events also. If you receive any event having first byte >= 128,
326  * it's a 8 byte event.
327  *
328  * The events are documented at the end of this file.
329  *
330  * Normal events (4 bytes)
331  * There is also a 8 byte version of most of the 4 byte events. The
332  * 8 byte one is recommended.
333  */
334 #define SEQ_NOTEOFF		0
335 #define SEQ_FMNOTEOFF		SEQ_NOTEOFF	/* Just old name */
336 #define SEQ_NOTEON		1
337 #define	SEQ_FMNOTEON		SEQ_NOTEON
338 #define SEQ_WAIT		TMR_WAIT_ABS
339 #define SEQ_PGMCHANGE		3
340 #define SEQ_FMPGMCHANGE		SEQ_PGMCHANGE
341 #define SEQ_SYNCTIMER		TMR_START
342 #define SEQ_MIDIPUTC		5
343 #define SEQ_DRUMON		6	/*** OBSOLETE ***/
344 #define SEQ_DRUMOFF		7	/*** OBSOLETE ***/
345 #define SEQ_ECHO		TMR_ECHO	/* For synching programs with output */
346 #define SEQ_AFTERTOUCH		9
347 #define SEQ_CONTROLLER		10
348 
349 /*******************************************
350  *	Midi controller numbers
351  *******************************************
352  * Controllers 0 to 31 (0x00 to 0x1f) and
353  * 32 to 63 (0x20 to 0x3f) are continuous
354  * controllers.
355  * In the MIDI 1.0 these controllers are sent using
356  * two messages. Controller numbers 0 to 31 are used
357  * to send the MSB and the controller numbers 32 to 63
358  * are for the LSB. Note that just 7 bits are used in MIDI bytes.
359  */
360 
361 #define	   CTL_BANK_SELECT		0x00
362 #define	   CTL_MODWHEEL			0x01
363 #define    CTL_BREATH			0x02
364 /*		undefined		0x03 */
365 #define    CTL_FOOT			0x04
366 #define    CTL_PORTAMENTO_TIME		0x05
367 #define    CTL_DATA_ENTRY		0x06
368 #define    CTL_MAIN_VOLUME		0x07
369 #define    CTL_BALANCE			0x08
370 /*		undefined		0x09 */
371 #define    CTL_PAN			0x0a
372 #define    CTL_EXPRESSION		0x0b
373 /*		undefined		0x0c */
374 /*		undefined		0x0d */
375 /*		undefined		0x0e */
376 /*		undefined		0x0f */
377 #define    CTL_GENERAL_PURPOSE1	0x10
378 #define    CTL_GENERAL_PURPOSE2	0x11
379 #define    CTL_GENERAL_PURPOSE3	0x12
380 #define    CTL_GENERAL_PURPOSE4	0x13
381 /*		undefined		0x14 - 0x1f */
382 
383 /*		undefined		0x20 */
384 /* The controller numbers 0x21 to 0x3f are reserved for the */
385 /* least significant bytes of the controllers 0x00 to 0x1f. */
386 /* These controllers are not recognized by the driver. */
387 
388 /* Controllers 64 to 69 (0x40 to 0x45) are on/off switches. */
389 /* 0=OFF and 127=ON (intermediate values are possible) */
390 #define    CTL_DAMPER_PEDAL		0x40
391 #define    CTL_SUSTAIN			0x40	/* Alias */
392 #define    CTL_HOLD			0x40	/* Alias */
393 #define    CTL_PORTAMENTO		0x41
394 #define    CTL_SOSTENUTO		0x42
395 #define    CTL_SOFT_PEDAL		0x43
396 /*		undefined		0x44 */
397 #define    CTL_HOLD2			0x45
398 /*		undefined		0x46 - 0x4f */
399 
400 #define    CTL_GENERAL_PURPOSE5	0x50
401 #define    CTL_GENERAL_PURPOSE6	0x51
402 #define    CTL_GENERAL_PURPOSE7	0x52
403 #define    CTL_GENERAL_PURPOSE8	0x53
404 /*		undefined		0x54 - 0x5a */
405 #define    CTL_EXT_EFF_DEPTH		0x5b
406 #define    CTL_TREMOLO_DEPTH		0x5c
407 #define    CTL_CHORUS_DEPTH		0x5d
408 #define    CTL_DETUNE_DEPTH		0x5e
409 #define    CTL_CELESTE_DEPTH		0x5e	/* Alias for the above one */
410 #define    CTL_PHASER_DEPTH		0x5f
411 #define    CTL_DATA_INCREMENT		0x60
412 #define    CTL_DATA_DECREMENT		0x61
413 #define    CTL_NONREG_PARM_NUM_LSB	0x62
414 #define    CTL_NONREG_PARM_NUM_MSB	0x63
415 #define    CTL_REGIST_PARM_NUM_LSB	0x64
416 #define    CTL_REGIST_PARM_NUM_MSB	0x65
417 /*		undefined		0x66 - 0x78 */
418 /*		reserved		0x79 - 0x7f */
419 
420 /* Pseudo controllers (not midi compatible) */
421 #define    CTRL_PITCH_BENDER		255
422 #define    CTRL_PITCH_BENDER_RANGE	254
423 #define    CTRL_EXPRESSION		253	/* Obsolete */
424 #define    CTRL_MAIN_VOLUME		252	/* Obsolete */
425 #define SEQ_BALANCE		11
426 #define SEQ_VOLMODE             12
427 
428 /*
429  * Volume mode decides how volumes are used
430  */
431 
432 #define VOL_METHOD_ADAGIO	1
433 #define VOL_METHOD_LINEAR	2
434 
435 /*
436  * Note! SEQ_WAIT, SEQ_MIDIPUTC and SEQ_ECHO are used also as
437  *	 input events.
438  */
439 
440 /*
441  * Event codes 0xf0 to 0xfc are reserved for future extensions.
442  */
443 
444 #define SEQ_FULLSIZE		0xfd	/* Long events */
445 /*
446  *	SEQ_FULLSIZE events are used for loading patches/samples to the
447  *	synthesizer devices. These events are passed directly to the driver
448  *	of the associated synthesizer device. There is no limit to the size
449  *	of the extended events. These events are not queued but executed
450  *	immediately when the write() is called (execution can take several
451  *	seconds of time).
452  *
453  *	When a SEQ_FULLSIZE message is written to the device, it must
454  *	be written using exactly one write() call. Other events cannot
455  *	be mixed to the same write.
456  *
457  *	For FM synths (YM3812/OPL3) use struct sbi_instrument and write it to the
458  *	/dev/sequencer. Don't write other data together with the instrument structure
459  *	Set the key field of the structure to FM_PATCH. The device field is used to
460  *	route the patch to the corresponding device.
461  *
462  *	For Gravis UltraSound use struct patch_info. Initialize the key field
463  *      to GUS_PATCH.
464  */
465 #define SEQ_PRIVATE		0xfe	/* Low level HW dependent events (8 bytes) */
466 #define SEQ_EXTENDED		0xff	/* Extended events (8 bytes) OBSOLETE */
467 
468 /*
469  * Record for FM patches
470  */
471 
472 typedef unsigned char sbi_instr_data[32];
473 
474 struct sbi_instrument {
475 		unsigned short	key;		/* 	Initialize to FM_PATCH or OPL3_PATCH */
476 #define FM_PATCH	0x01fd
477 #define OPL3_PATCH	0x03fd
478 		short		device;		/*	Synth# (0-4)	*/
479 		int 		channel;	/*	Program# to be initialized 	*/
480 		sbi_instr_data	operators;	/*	Register settings for operator cells (.SBI format)	*/
481 	};
482 
483 struct synth_info {	/* Read only */
484 		char	name[30];
485 		int	device;		/* 0-N. INITIALIZE BEFORE CALLING */
486 		int	synth_type;
487 #define SYNTH_TYPE_FM			0
488 #define SYNTH_TYPE_SAMPLE		1
489 #define SYNTH_TYPE_MIDI			2	/* Midi interface */
490 
491 		int	synth_subtype;
492 #define FM_TYPE_ADLIB			0x00
493 #define FM_TYPE_OPL3			0x01
494 
495 #define SAMPLE_TYPE_GUS			0x10
496 
497 		int	perc_mode;	/* No longer supported */
498 		int	nr_voices;
499 		int	nr_drums;	/* Obsolete field */
500 		int	instr_bank_size;
501 		unsigned long	capabilities;
502 #define SYNTH_CAP_PERCMODE		0x00000001 /* No longer used */
503 #define SYNTH_CAP_OPL3			0x00000002 /* Set if OPL3 supported */
504 #define SYNTH_CAP_INPUT			0x00000004 /* Input (MIDI) device */
505 		int	dummies[19];	/* Reserve space */
506 	};
507 
508 struct sound_timer_info {
509 		char name[30];
510 		int caps;
511 	};
512 
513 #define MIDI_CAP_MPU401		1		/* MPU-401 intelligent mode */
514 
515 struct midi_info {
516 		char		name[30];
517 		int		device;		/* 0-N. INITIALIZE BEFORE CALLING */
518 		unsigned long	capabilities;	/* To be defined later */
519 		int		dev_type;
520 		int		dummies[18];	/* Reserve space */
521 	};
522 
523 /********************************************
524  * ioctl commands for the /dev/midi##
525  */
526 typedef struct {
527 		unsigned char cmd;
528 		char nr_args, nr_returns;
529 		unsigned char data[30];
530 	} mpu_command_rec;
531 
532 #define SNDCTL_MIDI_PRETIME		_IOWR('m', 0, int)
533 #define SNDCTL_MIDI_MPUMODE		_IOWR('m', 1, int)
534 #define SNDCTL_MIDI_MPUCMD		_IOWR('m', 2, mpu_command_rec)
535 
536 /********************************************
537  * IOCTL commands for /dev/dsp and /dev/audio
538  */
539 
540 #define SNDCTL_DSP_RESET		_IO  ('P', 0)
541 #define SNDCTL_DSP_SYNC			_IO  ('P', 1)
542 #define SNDCTL_DSP_SPEED		_IOWR('P', 2, int)
543 #define SNDCTL_DSP_STEREO		_IOWR('P', 3, int)
544 #define SNDCTL_DSP_GETBLKSIZE		_IOR('P', 4, int)
545 #define SNDCTL_DSP_SETBLKSIZE		_IOW('P', 4, int)
546 #define SNDCTL_DSP_SAMPLESIZE		SNDCTL_DSP_SETFMT
547 #define SOUND_PCM_WRITE_CHANNELS	_IOWR('P', 6, int)
548 #define SOUND_PCM_WRITE_FILTER		_IOWR('P', 7, int)
549 #define SNDCTL_DSP_POST			_IO  ('P', 8)
550 #define SNDCTL_DSP_SUBDIVIDE		_IOWR('P', 9, int)
551 #define SNDCTL_DSP_SETFRAGMENT		_IOWR('P',10, int)
552 
553 /*	Audio data formats (Note! U8=8 and S16_LE=16 for compatibility) */
554 #define SNDCTL_DSP_GETFMTS		_IOR ('P',11, int) /* Returns a mask */
555 #define SNDCTL_DSP_SETFMT		_IOWR('P',5, int) /* Selects ONE fmt*/
556 #	define AFMT_QUERY		0x00000000	/* Return current fmt */
557 #	define AFMT_MU_LAW		0x00000001
558 #	define AFMT_A_LAW		0x00000002
559 #	define AFMT_IMA_ADPCM		0x00000004
560 #	define AFMT_U8			0x00000008
561 #	define AFMT_S16_LE		0x00000010	/* Little endian signed 16*/
562 #	define AFMT_S16_BE		0x00000020	/* Big endian signed 16 */
563 #	define AFMT_S8			0x00000040
564 #	define AFMT_U16_LE		0x00000080	/* Little endian U16 */
565 #	define AFMT_U16_BE		0x00000100	/* Big endian U16 */
566 #	define AFMT_MPEG		0x00000200	/* MPEG (2) audio */
567 
568 /*
569  * Buffer status queries.
570  */
571 typedef struct audio_buf_info {
572 			int fragments;	/* # of available fragments (partially usend ones not counted) */
573 			int fragsize;	/* Size of a fragment in bytes */
574 
575 			int bytes;	/* Available space in bytes (includes partially used fragments) */
576 			/* Note! 'bytes' could be more than fragments*fragsize */
577 		} audio_buf_info;
578 
579 #define SNDCTL_DSP_GETOSPACE		_IOR ('P',12, audio_buf_info)
580 #define SNDCTL_DSP_GETISPACE		_IOR ('P',13, audio_buf_info)
581 #define SNDCTL_DSP_NONBLOCK		_IO  ('P',14)
582 
583 #define SOUND_PCM_READ_RATE		_IOR ('P', 2, int)
584 #define SOUND_PCM_READ_CHANNELS		_IOR ('P', 6, int)
585 #define SOUND_PCM_READ_BITS		_IOR ('P', 5, int)
586 #define SOUND_PCM_READ_FILTER		_IOR ('P', 7, int)
587 
588 /* Some alias names */
589 #define SOUND_PCM_WRITE_BITS		SNDCTL_DSP_SETFMT
590 #define SOUND_PCM_WRITE_RATE		SNDCTL_DSP_SPEED
591 #define SOUND_PCM_POST			SNDCTL_DSP_POST
592 #define SOUND_PCM_RESET			SNDCTL_DSP_RESET
593 #define SOUND_PCM_SYNC			SNDCTL_DSP_SYNC
594 #define SOUND_PCM_SUBDIVIDE		SNDCTL_DSP_SUBDIVIDE
595 #define SOUND_PCM_SETFRAGMENT		SNDCTL_DSP_SETFRAGMENT
596 #define SOUND_PCM_GETFMTS		SNDCTL_DSP_GETFMTS
597 #define SOUND_PCM_SETFMT		SNDCTL_DSP_SETFMT
598 #define SOUND_PCM_GETOSPACE		SNDCTL_DSP_GETOSPACE
599 #define SOUND_PCM_GETISPACE		SNDCTL_DSP_GETISPACE
600 #define SOUND_PCM_NONBLOCK		SNDCTL_DSP_NONBLOCK
601 
602 /*
603  * ioctl calls to be used in communication with coprocessors and
604  * DSP chips.
605  */
606 
607 typedef struct copr_buffer {
608 		int command;	/* Set to 0 if not used */
609 		int flags;
610 #define CPF_NONE		0x0000
611 #define CPF_FIRST		0x0001	/* First block */
612 #define CPF_LAST		0x0002	/* Last block */
613 		int len;
614 		int offs;	/* If required by the device (0 if not used) */
615 
616 		unsigned char data[4000]; /* NOTE! 4000 is not 4k */
617 	} copr_buffer;
618 
619 typedef struct copr_debug_buf {
620 		int command;	/* Used internally. Set to 0 */
621 		int parm1;
622 		int parm2;
623 		int flags;
624 		int len;	/* Length of data in bytes */
625 	} copr_debug_buf;
626 
627 typedef struct copr_msg {
628 		int len;
629 		unsigned char data[4000];
630 	} copr_msg;
631 
632 #define SNDCTL_COPR_RESET             _IO  ('C',  0)
633 #define SNDCTL_COPR_LOAD	      _IOWR('C',  1, copr_buffer)
634 #define SNDCTL_COPR_RDATA	      _IOWR('C',  2, copr_debug_buf)
635 #define SNDCTL_COPR_RCODE	      _IOWR('C',  3, copr_debug_buf)
636 #define SNDCTL_COPR_WDATA	      _IOW ('C',  4, copr_debug_buf)
637 #define SNDCTL_COPR_WCODE	      _IOW ('C',  5, copr_debug_buf)
638 #define SNDCTL_COPR_RUN		      _IOWR('C',  6, copr_debug_buf)
639 #define SNDCTL_COPR_HALT	      _IOWR('C',  7, copr_debug_buf)
640 #define SNDCTL_COPR_SENDMSG	      _IOW ('C',  8, copr_msg)
641 #define SNDCTL_COPR_RCVMSG	      _IOR ('C',  9, copr_msg)
642 
643 /*********************************************
644  * IOCTL commands for /dev/mixer
645  */
646 
647 /*
648  * Mixer devices
649  *
650  * There can be up to 20 different analog mixer channels. The
651  * SOUND_MIXER_NRDEVICES gives the currently supported maximum.
652  * The SOUND_MIXER_READ_DEVMASK returns a bitmask which tells
653  * the devices supported by the particular mixer.
654  */
655 
656 #define SOUND_MIXER_NRDEVICES	17
657 #define SOUND_MIXER_VOLUME	0
658 #define SOUND_MIXER_BASS	1
659 #define SOUND_MIXER_TREBLE	2
660 #define SOUND_MIXER_SYNTH	3
661 #define SOUND_MIXER_PCM		4
662 #define SOUND_MIXER_SPEAKER	5
663 #define SOUND_MIXER_LINE	6
664 #define SOUND_MIXER_MIC		7
665 #define SOUND_MIXER_CD		8
666 #define SOUND_MIXER_IMIX	9	/*  Recording monitor  */
667 #define SOUND_MIXER_ALTPCM	10
668 #define SOUND_MIXER_RECLEV	11	/* Recording level */
669 #define SOUND_MIXER_IGAIN	12	/* Input gain */
670 #define SOUND_MIXER_OGAIN	13	/* Output gain */
671 /*
672  * The AD1848 codec and compatibles have three line level inputs
673  * (line, aux1 and aux2). Since each card manufacturer have assigned
674  * different meanings to these inputs, it's impractical to assign
675  * specific meanings (line, cd, synth etc.) to them.
676  */
677 #define SOUND_MIXER_LINE1	14	/* Input source 1  (aux1) */
678 #define SOUND_MIXER_LINE2	15	/* Input source 2  (aux2) */
679 #define SOUND_MIXER_LINE3	16	/* Input source 3  (line) */
680 
681 /* Some on/off settings (SOUND_SPECIAL_MIN - SOUND_SPECIAL_MAX) */
682 /* Not counted to SOUND_MIXER_NRDEVICES, but use the same number space */
683 #define SOUND_ONOFF_MIN		28
684 #define SOUND_ONOFF_MAX		30
685 #define SOUND_MIXER_MUTE	28	/* 0 or 1 */
686 #define SOUND_MIXER_ENHANCE	29	/* Enhanced stereo (0, 40, 60 or 80) */
687 #define SOUND_MIXER_LOUD	30	/* 0 or 1 */
688 
689 /* Note!	Number 31 cannot be used since the sign bit is reserved */
690 
691 #define SOUND_DEVICE_LABELS	{"Vol  ", "Bass ", "Trebl", "Synth", "Pcm  ", "Spkr ", "Line ", \
692 				 "Mic  ", "CD   ", "Mix  ", "Pcm2 ", "Rec  ", "IGain", "OGain", \
693 				 "Line1", "Line2", "Line3"}
694 
695 #define SOUND_DEVICE_NAMES	{"vol", "bass", "treble", "synth", "pcm", "speaker", "line", \
696 				 "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain", \
697 				 "line1", "line2", "line3"}
698 
699 /*	Device bitmask identifiers	*/
700 
701 #define SOUND_MIXER_RECSRC	0xff	/* Arg contains a bit for each recording source */
702 #define SOUND_MIXER_DEVMASK	0xfe	/* Arg contains a bit for each supported device */
703 #define SOUND_MIXER_RECMASK	0xfd	/* Arg contains a bit for each supported recording source */
704 #define SOUND_MIXER_CAPS	0xfc
705 	#define SOUND_CAP_EXCL_INPUT	0x00000001	/* Only one recording source at a time */
706 #define SOUND_MIXER_STEREODEVS	0xfb	/* Mixer channels supporting stereo */
707 
708 /*	Device mask bits	*/
709 
710 #define SOUND_MASK_VOLUME	(1 << SOUND_MIXER_VOLUME)
711 #define SOUND_MASK_BASS		(1 << SOUND_MIXER_BASS)
712 #define SOUND_MASK_TREBLE	(1 << SOUND_MIXER_TREBLE)
713 #define SOUND_MASK_SYNTH	(1 << SOUND_MIXER_SYNTH)
714 #define SOUND_MASK_PCM		(1 << SOUND_MIXER_PCM)
715 #define SOUND_MASK_SPEAKER	(1 << SOUND_MIXER_SPEAKER)
716 #define SOUND_MASK_LINE		(1 << SOUND_MIXER_LINE)
717 #define SOUND_MASK_MIC		(1 << SOUND_MIXER_MIC)
718 #define SOUND_MASK_CD		(1 << SOUND_MIXER_CD)
719 #define SOUND_MASK_IMIX		(1 << SOUND_MIXER_IMIX)
720 #define SOUND_MASK_ALTPCM	(1 << SOUND_MIXER_ALTPCM)
721 #define SOUND_MASK_RECLEV	(1 << SOUND_MIXER_RECLEV)
722 #define SOUND_MASK_IGAIN	(1 << SOUND_MIXER_IGAIN)
723 #define SOUND_MASK_OGAIN	(1 << SOUND_MIXER_OGAIN)
724 #define SOUND_MASK_LINE1	(1 << SOUND_MIXER_LINE1)
725 #define SOUND_MASK_LINE2	(1 << SOUND_MIXER_LINE2)
726 #define SOUND_MASK_LINE3	(1 << SOUND_MIXER_LINE3)
727 
728 #define SOUND_MASK_MUTE		(1 << SOUND_MIXER_MUTE)
729 #define SOUND_MASK_ENHANCE	(1 << SOUND_MIXER_ENHANCE)
730 #define SOUND_MASK_LOUD		(1 << SOUND_MIXER_LOUD)
731 
732 #define MIXER_READ(dev)		_IOR('M', dev, int)
733 #define SOUND_MIXER_READ_VOLUME		MIXER_READ(SOUND_MIXER_VOLUME)
734 #define SOUND_MIXER_READ_BASS		MIXER_READ(SOUND_MIXER_BASS)
735 #define SOUND_MIXER_READ_TREBLE		MIXER_READ(SOUND_MIXER_TREBLE)
736 #define SOUND_MIXER_READ_SYNTH		MIXER_READ(SOUND_MIXER_SYNTH)
737 #define SOUND_MIXER_READ_PCM		MIXER_READ(SOUND_MIXER_PCM)
738 #define SOUND_MIXER_READ_SPEAKER	MIXER_READ(SOUND_MIXER_SPEAKER)
739 #define SOUND_MIXER_READ_LINE		MIXER_READ(SOUND_MIXER_LINE)
740 #define SOUND_MIXER_READ_MIC		MIXER_READ(SOUND_MIXER_MIC)
741 #define SOUND_MIXER_READ_CD		MIXER_READ(SOUND_MIXER_CD)
742 #define SOUND_MIXER_READ_IMIX		MIXER_READ(SOUND_MIXER_IMIX)
743 #define SOUND_MIXER_READ_ALTPCM		MIXER_READ(SOUND_MIXER_ALTPCM)
744 #define SOUND_MIXER_READ_RECLEV		MIXER_READ(SOUND_MIXER_RECLEV)
745 #define SOUND_MIXER_READ_IGAIN		MIXER_READ(SOUND_MIXER_IGAIN)
746 #define SOUND_MIXER_READ_OGAIN		MIXER_READ(SOUND_MIXER_OGAIN)
747 #define SOUND_MIXER_READ_LINE1		MIXER_READ(SOUND_MIXER_LINE1)
748 #define SOUND_MIXER_READ_LINE2		MIXER_READ(SOUND_MIXER_LINE2)
749 #define SOUND_MIXER_READ_LINE3		MIXER_READ(SOUND_MIXER_LINE3)
750 #define SOUND_MIXER_READ_MUTE		MIXER_READ(SOUND_MIXER_MUTE)
751 #define SOUND_MIXER_READ_ENHANCE	MIXER_READ(SOUND_MIXER_ENHANCE)
752 #define SOUND_MIXER_READ_LOUD		MIXER_READ(SOUND_MIXER_LOUD)
753 
754 #define SOUND_MIXER_READ_RECSRC		MIXER_READ(SOUND_MIXER_RECSRC)
755 #define SOUND_MIXER_READ_DEVMASK	MIXER_READ(SOUND_MIXER_DEVMASK)
756 #define SOUND_MIXER_READ_RECMASK	MIXER_READ(SOUND_MIXER_RECMASK)
757 #define SOUND_MIXER_READ_STEREODEVS	MIXER_READ(SOUND_MIXER_STEREODEVS)
758 #define SOUND_MIXER_READ_CAPS		MIXER_READ(SOUND_MIXER_CAPS)
759 
760 #define MIXER_WRITE(dev)		_IOWR('M', dev, int)
761 #define SOUND_MIXER_WRITE_VOLUME	MIXER_WRITE(SOUND_MIXER_VOLUME)
762 #define SOUND_MIXER_WRITE_BASS		MIXER_WRITE(SOUND_MIXER_BASS)
763 #define SOUND_MIXER_WRITE_TREBLE	MIXER_WRITE(SOUND_MIXER_TREBLE)
764 #define SOUND_MIXER_WRITE_SYNTH		MIXER_WRITE(SOUND_MIXER_SYNTH)
765 #define SOUND_MIXER_WRITE_PCM		MIXER_WRITE(SOUND_MIXER_PCM)
766 #define SOUND_MIXER_WRITE_SPEAKER	MIXER_WRITE(SOUND_MIXER_SPEAKER)
767 #define SOUND_MIXER_WRITE_LINE		MIXER_WRITE(SOUND_MIXER_LINE)
768 #define SOUND_MIXER_WRITE_MIC		MIXER_WRITE(SOUND_MIXER_MIC)
769 #define SOUND_MIXER_WRITE_CD		MIXER_WRITE(SOUND_MIXER_CD)
770 #define SOUND_MIXER_WRITE_IMIX		MIXER_WRITE(SOUND_MIXER_IMIX)
771 #define SOUND_MIXER_WRITE_ALTPCM	MIXER_WRITE(SOUND_MIXER_ALTPCM)
772 #define SOUND_MIXER_WRITE_RECLEV	MIXER_WRITE(SOUND_MIXER_RECLEV)
773 #define SOUND_MIXER_WRITE_IGAIN		MIXER_WRITE(SOUND_MIXER_IGAIN)
774 #define SOUND_MIXER_WRITE_OGAIN		MIXER_WRITE(SOUND_MIXER_OGAIN)
775 #define SOUND_MIXER_WRITE_LINE1		MIXER_WRITE(SOUND_MIXER_LINE1)
776 #define SOUND_MIXER_WRITE_LINE2		MIXER_WRITE(SOUND_MIXER_LINE2)
777 #define SOUND_MIXER_WRITE_LINE3		MIXER_WRITE(SOUND_MIXER_LINE3)
778 #define SOUND_MIXER_WRITE_MUTE		MIXER_WRITE(SOUND_MIXER_MUTE)
779 #define SOUND_MIXER_WRITE_ENHANCE	MIXER_WRITE(SOUND_MIXER_ENHANCE)
780 #define SOUND_MIXER_WRITE_LOUD		MIXER_WRITE(SOUND_MIXER_LOUD)
781 
782 #define SOUND_MIXER_WRITE_RECSRC	MIXER_WRITE(SOUND_MIXER_RECSRC)
783 
784 /*
785  * Level 2 event types for /dev/sequencer
786  */
787 
788 /*
789  * The 4 most significant bits of byte 0 specify the class of
790  * the event:
791  *
792  *	0x8X = system level events,
793  *	0x9X = device/port specific events, event[1] = device/port,
794  *		The last 4 bits give the subtype:
795  *			0x02	= Channel event (event[3] = chn).
796  *			0x01	= note event (event[4] = note).
797  *			(0x01 is not used alone but always with bit 0x02).
798  *	       event[2] = MIDI message code (0x80=note off etc.)
799  *
800  */
801 
802 #define EV_SEQ_LOCAL		0x80
803 #define EV_TIMING		0x81
804 #define EV_CHN_COMMON		0x92
805 #define EV_CHN_VOICE		0x93
806 /*
807  * Event types 200 to 220 are reserved for application use.
808  * These numbers will not be used by the driver.
809  */
810 
811 /*
812  * Events for event type EV_CHN_VOICE
813  */
814 
815 #define MIDI_NOTEOFF		0x80
816 #define MIDI_NOTEON		0x90
817 #define MIDI_KEY_PRESSURE	0xA0
818 
819 /*
820  * Events for event type EV_CHN_COMMON
821  */
822 
823 #define MIDI_CTL_CHANGE		0xB0
824 #define MIDI_PGM_CHANGE		0xC0
825 #define MIDI_CHN_PRESSURE	0xD0
826 #define MIDI_PITCH_BEND		0xE0
827 
828 #define MIDI_SYSTEM_PREFIX	0xF0
829 
830 /*
831  * Timer event types
832  */
833 #define TMR_WAIT_REL		1	/* Time relative to the prev time */
834 #define TMR_WAIT_ABS		2	/* Absolute time since TMR_START */
835 #define TMR_STOP		3
836 #define TMR_START		4
837 #define TMR_CONTINUE		5
838 #define TMR_TEMPO		6
839 #define TMR_ECHO		8
840 #define TMR_CLOCK		9	/* MIDI clock */
841 #define TMR_SPP			10	/* Song position pointer */
842 #define TMR_TIMESIG		11	/* Time signature */
843 
844 #if (!defined(__KERNEL__) && !defined(KERNEL) && !defined(INKERNEL) && !defined(_KERNEL)) || defined(USE_SEQ_MACROS)
845 /*
846  *	Some convenience macros to simplify programming of the
847  *	/dev/sequencer interface
848  *
849  *	These macros define the API which should be used when possible.
850  */
851 
852 #ifndef USE_SIMPLE_MACROS
853 void seqbuf_dump(void);	/* This function must be provided by programs */
854 
855 /* Sample seqbuf_dump() implementation:
856  *
857  *	SEQ_DEFINEBUF (2048);	-- Defines a buffer for 2048 bytes
858  *
859  *	int seqfd;		-- The file descriptor for /dev/sequencer.
860  *
861  *	void
862  *	seqbuf_dump ()
863  *	{
864  *	  if (_seqbufptr)
865  *	    if (write (seqfd, _seqbuf, _seqbufptr) == -1)
866  *	      {
867  *		perror ("write /dev/sequencer");
868  *		exit (-1);
869  *	      }
870  *	  _seqbufptr = 0;
871  *	}
872  */
873 
874 #define SEQ_DEFINEBUF(len)		unsigned char _seqbuf[len]; int _seqbuflen = len;int _seqbufptr = 0
875 #define SEQ_USE_EXTBUF()		extern unsigned char _seqbuf[]; extern int _seqbuflen;extern int _seqbufptr
876 #define SEQ_DECLAREBUF()		SEQ_USE_EXTBUF()
877 #define SEQ_PM_DEFINES			struct patmgr_info _pm_info
878 #define _SEQ_NEEDBUF(len)		if ((_seqbufptr+(len)) > _seqbuflen) seqbuf_dump()
879 #define _SEQ_ADVBUF(len)		_seqbufptr += len
880 #define SEQ_DUMPBUF			seqbuf_dump
881 #else
882 /*
883  * This variation of the sequencer macros is used just to format one event
884  * using fixed buffer.
885  *
886  * The program using the macro library must define the following macros before
887  * using this library.
888  *
889  * #define _seqbuf 		 name of the buffer (unsigned char[])
890  * #define _SEQ_ADVBUF(len)	 If the applic needs to know the exact
891  *				 size of the event, this macro can be used.
892  *				 Otherwise this must be defined as empty.
893  * #define _seqbufptr		 Define the name of index variable or 0 if
894  *				 not required.
895  */
896 #define _SEQ_NEEDBUF(len)	/* empty */
897 #endif
898 
899 #define PM_LOAD_PATCH(dev, bank, pgm)	(SEQ_DUMPBUF(), _pm_info.command = _PM_LOAD_PATCH, \
900 					_pm_info.device=dev, _pm_info.data.data8[0]=pgm, \
901 					_pm_info.parm1 = bank, _pm_info.parm2 = 1, \
902 					ioctl(seqfd, SNDCTL_PMGR_ACCESS, &_pm_info))
903 #define PM_LOAD_PATCHES(dev, bank, pgm) (SEQ_DUMPBUF(), _pm_info.command = _PM_LOAD_PATCH, \
904 					_pm_info.device=dev, memcpy(_pm_info.data.data8, pgm, 128), \
905 					_pm_info.parm1 = bank, _pm_info.parm2 = 128, \
906 					ioctl(seqfd, SNDCTL_PMGR_ACCESS, &_pm_info))
907 
908 #define SEQ_VOLUME_MODE(dev, mode)	{_SEQ_NEEDBUF(8);\
909 					_seqbuf[_seqbufptr] = SEQ_EXTENDED;\
910 					_seqbuf[_seqbufptr+1] = SEQ_VOLMODE;\
911 					_seqbuf[_seqbufptr+2] = (dev);\
912 					_seqbuf[_seqbufptr+3] = (mode);\
913 					_seqbuf[_seqbufptr+4] = 0;\
914 					_seqbuf[_seqbufptr+5] = 0;\
915 					_seqbuf[_seqbufptr+6] = 0;\
916 					_seqbuf[_seqbufptr+7] = 0;\
917 					_SEQ_ADVBUF(8);}
918 
919 /*
920  * Midi voice messages
921  */
922 
923 #define _CHN_VOICE(dev, event, chn, note, parm) \
924 					{_SEQ_NEEDBUF(8);\
925 					_seqbuf[_seqbufptr] = EV_CHN_VOICE;\
926 					_seqbuf[_seqbufptr+1] = (dev);\
927 					_seqbuf[_seqbufptr+2] = (event);\
928 					_seqbuf[_seqbufptr+3] = (chn);\
929 					_seqbuf[_seqbufptr+4] = (note);\
930 					_seqbuf[_seqbufptr+5] = (parm);\
931 					_seqbuf[_seqbufptr+6] = (0);\
932 					_seqbuf[_seqbufptr+7] = 0;\
933 					_SEQ_ADVBUF(8);}
934 
935 #define SEQ_START_NOTE(dev, chn, note, vol) \
936 		_CHN_VOICE(dev, MIDI_NOTEON, chn, note, vol)
937 
938 #define SEQ_STOP_NOTE(dev, chn, note, vol) \
939 		_CHN_VOICE(dev, MIDI_NOTEOFF, chn, note, vol)
940 
941 #define SEQ_KEY_PRESSURE(dev, chn, note, pressure) \
942 		_CHN_VOICE(dev, MIDI_KEY_PRESSURE, chn, note, pressure)
943 
944 /*
945  * Midi channel messages
946  */
947 
948 #define _CHN_COMMON(dev, event, chn, p1, p2, w14) \
949 					{_SEQ_NEEDBUF(8);\
950 					_seqbuf[_seqbufptr] = EV_CHN_COMMON;\
951 					_seqbuf[_seqbufptr+1] = (dev);\
952 					_seqbuf[_seqbufptr+2] = (event);\
953 					_seqbuf[_seqbufptr+3] = (chn);\
954 					_seqbuf[_seqbufptr+4] = (p1);\
955 					_seqbuf[_seqbufptr+5] = (p2);\
956 					*(short *)&_seqbuf[_seqbufptr+6] = (w14);\
957 					_SEQ_ADVBUF(8);}
958 
959 #define SEQ_CHN_PRESSURE(dev, chn, pressure) \
960 		_CHN_COMMON(dev, MIDI_CHN_PRESSURE, chn, pressure, 0, 0)
961 
962 #define SEQ_SET_PATCH(dev, chn, patch) \
963 		_CHN_COMMON(dev, MIDI_PGM_CHANGE, chn, patch, 0, 0)
964 
965 #define SEQ_CONTROL(dev, chn, controller, value) \
966 		_CHN_COMMON(dev, MIDI_CTL_CHANGE, chn, controller, 0, value)
967 
968 #define SEQ_BENDER(dev, chn, value) \
969 		_CHN_COMMON(dev, MIDI_PITCH_BEND, chn, 0, 0, value)
970 
971 
972 #define SEQ_V2_X_CONTROL(dev, voice, controller, value)	{_SEQ_NEEDBUF(8);\
973 					_seqbuf[_seqbufptr] = SEQ_EXTENDED;\
974 					_seqbuf[_seqbufptr+1] = SEQ_CONTROLLER;\
975 					_seqbuf[_seqbufptr+2] = (dev);\
976 					_seqbuf[_seqbufptr+3] = (voice);\
977 					_seqbuf[_seqbufptr+4] = (controller);\
978 					*(short *)&_seqbuf[_seqbufptr+5] = (value);\
979 					_seqbuf[_seqbufptr+7] = 0;\
980 					_SEQ_ADVBUF(8);}
981 /*
982  * The following 5 macros are incorrectly implemented and obsolete.
983  * Use SEQ_BENDER and SEQ_CONTROL (with proper controller) instead.
984  */
985 #define SEQ_PITCHBEND(dev, voice, value) SEQ_V2_X_CONTROL(dev, voice, CTRL_PITCH_BENDER, value)
986 #define SEQ_BENDER_RANGE(dev, voice, value) SEQ_V2_X_CONTROL(dev, voice, CTRL_PITCH_BENDER_RANGE, value)
987 #define SEQ_EXPRESSION(dev, voice, value) SEQ_CONTROL(dev, voice, CTL_EXPRESSION, value*128)
988 #define SEQ_MAIN_VOLUME(dev, voice, value) SEQ_CONTROL(dev, voice, CTL_MAIN_VOLUME, (value*16383)/100)
989 #define SEQ_PANNING(dev, voice, pos) SEQ_CONTROL(dev, voice, CTL_PAN, (pos+128) / 2)
990 #if 0
991 #define SEQ_PANNING(dev, voice, pos)	{_SEQ_NEEDBUF(8);\
992 					_seqbuf[_seqbufptr] = SEQ_EXTENDED;\
993 					_seqbuf[_seqbufptr+1] = SEQ_BALANCE;\
994 					_seqbuf[_seqbufptr+2] = (dev);\
995 					_seqbuf[_seqbufptr+3] = (voice);\
996 					(char)_seqbuf[_seqbufptr+4] = (pos);\
997 					_seqbuf[_seqbufptr+5] = 0;\
998 					_seqbuf[_seqbufptr+6] = 0;\
999 					_seqbuf[_seqbufptr+7] = 1;\
1000 					_SEQ_ADVBUF(8);}
1001 #endif
1002 
1003 /*
1004  * Timing and synchronization macros
1005  */
1006 
1007 #define _TIMER_EVENT(ev, parm)		{_SEQ_NEEDBUF(8);\
1008 				 	_seqbuf[_seqbufptr+0] = EV_TIMING; \
1009 				 	_seqbuf[_seqbufptr+1] = (ev); \
1010 					_seqbuf[_seqbufptr+2] = 0;\
1011 					_seqbuf[_seqbufptr+3] = 0;\
1012 				 	*(unsigned int *)&_seqbuf[_seqbufptr+4] = (parm); \
1013 					_SEQ_ADVBUF(8);}
1014 
1015 #define SEQ_START_TIMER()		_TIMER_EVENT(TMR_START, 0)
1016 #define SEQ_STOP_TIMER()		_TIMER_EVENT(TMR_STOP, 0)
1017 #define SEQ_CONTINUE_TIMER()		_TIMER_EVENT(TMR_CONTINUE, 0)
1018 #define SEQ_WAIT_TIME(ticks)		_TIMER_EVENT(TMR_WAIT_ABS, ticks)
1019 #define SEQ_DELTA_TIME(ticks)		_TIMER_EVENT(TMR_WAIT_REL, ticks)
1020 #define SEQ_ECHO_BACK(key)		_TIMER_EVENT(TMR_ECHO, key)
1021 #define SEQ_SET_TEMPO(value)		_TIMER_EVENT(TMR_TEMPO, value)
1022 #define SEQ_SONGPOS(pos)		_TIMER_EVENT(TMR_SPP, pos)
1023 #define SEQ_TIME_SIGNATURE(sig)		_TIMER_EVENT(TMR_TIMESIG, sig)
1024 
1025 /*
1026  * Events for the level 1 interface only
1027  */
1028 
1029 #define SEQ_MIDIOUT(device, byte)	{_SEQ_NEEDBUF(4);\
1030 					_seqbuf[_seqbufptr] = SEQ_MIDIPUTC;\
1031 					_seqbuf[_seqbufptr+1] = (byte);\
1032 					_seqbuf[_seqbufptr+2] = (device);\
1033 					_seqbuf[_seqbufptr+3] = 0;\
1034 					_SEQ_ADVBUF(4);}
1035 
1036 /*
1037  * Patch loading.
1038  */
1039 #define SEQ_WRPATCH(patchx, len)		{if (_seqbufptr) seqbuf_dump();\
1040 					if (write(seqfd, (char*)(patchx), len)==-1) \
1041 					   perror("Write patch: /dev/sequencer");}
1042 #define SEQ_WRPATCH2(patchx, len)	(seqbuf_dump(), write(seqfd, (char*)(patchx), len))
1043 
1044 #endif
1045 #endif
1046