soundcard.h revision 9750
11638Srgrimes#ifndef SOUNDCARD_H
21638Srgrimes#define SOUNDCARD_H
31638Srgrimes/*
41638Srgrimes * Copyright by Hannu Savolainen 1993
51638Srgrimes *
61638Srgrimes * Redistribution and use in source and binary forms, with or without
71638Srgrimes * modification, are permitted provided that the following conditions
81638Srgrimes * are met:
91638Srgrimes * 1. Redistributions of source code must retain the above copyright
101638Srgrimes *    notice, this list of conditions and the following disclaimer.
111638Srgrimes * 2. Redistributions in binary form must reproduce the above copyright
121638Srgrimes *    notice, this list of conditions and the following disclaimer in the
131638Srgrimes *    documentation and/or other materials provided with the distribution.
141638Srgrimes *
151638Srgrimes * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
161638Srgrimes * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
171638Srgrimes * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
181638Srgrimes * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
191638Srgrimes * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
201638Srgrimes * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
211638Srgrimes * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
221638Srgrimes * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
231638Srgrimes * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
241638Srgrimes * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
251638Srgrimes * SUCH DAMAGE.
261638Srgrimes *
271638Srgrimes *
281638Srgrimes */
291638Srgrimes
301638Srgrimes /*
311638Srgrimes  * If you make modifications to this file, please contact me before
321638Srgrimes  * distributing the modified version. There is already enough
331638Srgrimes  * divercity in the world.
341638Srgrimes  *
351638Srgrimes  * Regards,
361638Srgrimes  * Hannu Savolainen
371638Srgrimes  * hannu@voxware.pp.fi
381638Srgrimes  */
391638Srgrimes
401638Srgrimes#define SOUND_VERSION	301
411638Srgrimes#define VOXWARE
421638Srgrimes
431638Srgrimes#include <sys/ioctl.h>
441638Srgrimes
451638Srgrimes/*
461638Srgrimes *	Supported card ID numbers (Should be somewhere else?)
471638Srgrimes */
481638Srgrimes
491638Srgrimes#define SNDCARD_ADLIB		1
501638Srgrimes#define SNDCARD_SB		2
511638Srgrimes#define SNDCARD_PAS		3
521638Srgrimes#define SNDCARD_GUS		4
531638Srgrimes#define SNDCARD_MPU401		5
541638Srgrimes#define SNDCARD_SB16		6
551638Srgrimes#define SNDCARD_SB16MIDI	7
561638Srgrimes#define SNDCARD_UART6850	8
571638Srgrimes#define SNDCARD_GUS16		9
581638Srgrimes#define SNDCARD_MSS		10
591638Srgrimes#define SNDCARD_PSS     	11
601638Srgrimes#define SNDCARD_SSCAPE		12
611638Srgrimes#define SNDCARD_PSS_MPU     	13
621638Srgrimes#define SNDCARD_PSS_MSS     	14
631638Srgrimes#define SNDCARD_SSCAPE_MSS	15
641638Srgrimes#define SNDCARD_TRXPRO		16
651638Srgrimes#define SNDCARD_TRXPRO_SB	17
661638Srgrimes#define SNDCARD_TRXPRO_MPU	18
671638Srgrimes
681638Srgrimes/***********************************
691638Srgrimes * IOCTL Commands for /dev/sequencer
701638Srgrimes */
711638Srgrimes
721638Srgrimes#ifndef _IOWR
731638Srgrimes/*	@(#)ioctlp.h */
741638Srgrimes
751638Srgrimes/* Ioctl's have the command encoded in the lower word,
761638Srgrimes * and the size of any in or out parameters in the upper
771638Srgrimes * word.  The high 2 bits of the upper word are used
781638Srgrimes * to encode the in/out status of the parameter; for now
791638Srgrimes * we restrict parameters to at most 128 bytes.
801638Srgrimes */
811638Srgrimes/* #define	IOCTYPE		(0xff<<8) */
821638Srgrimes#define	IOCPARM_MASK	0x7f		/* parameters must be < 128 bytes */
831638Srgrimes#define	IOC_VOID	0x00000000	/* no parameters */
841638Srgrimes#define	IOC_OUT		0x20000000	/* copy out parameters */
851638Srgrimes#define	IOC_IN		0x40000000	/* copy in parameters */
861638Srgrimes#define	IOC_INOUT	(IOC_IN|IOC_OUT)
871638Srgrimes/* the 0x20000000 is so we can distinguish new ioctl's from old */
881638Srgrimes#define	_IO(x,y)	((int)(IOC_VOID|(x<<8)|y))
891638Srgrimes#define	_IOR(x,y,t)	((int)(IOC_OUT|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
901638Srgrimes#define	_IOW(x,y,t)	((int)(IOC_IN|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
911638Srgrimes/* this should be _IORW, but stdio got there first */
921638Srgrimes#define	_IOWR(x,y,t)	((int)(IOC_INOUT|((sizeof(t)&IOCPARM_MASK)<<16)|(x<<8)|y))
931638Srgrimes#endif  /* !_IOWR */
941638Srgrimes
951638Srgrimes#define SNDCTL_SEQ_RESET		_IO  ('Q', 0)
961638Srgrimes#define SNDCTL_SEQ_SYNC			_IO  ('Q', 1)
971638Srgrimes#define SNDCTL_SYNTH_INFO		_IOWR('Q', 2, struct synth_info)
981638Srgrimes#define SNDCTL_SEQ_CTRLRATE		_IOWR('Q', 3, int)	/* Set/get timer resolution (HZ) */
991638Srgrimes#define SNDCTL_SEQ_GETOUTCOUNT		_IOR ('Q', 4, int)
1001638Srgrimes#define SNDCTL_SEQ_GETINCOUNT		_IOR ('Q', 5, int)
1011638Srgrimes#define SNDCTL_SEQ_PERCMODE		_IOW ('Q', 6, int)
1021638Srgrimes#define SNDCTL_FM_LOAD_INSTR		_IOW ('Q', 7, struct sbi_instrument)	/* Valid for FM only */
1031638Srgrimes#define SNDCTL_SEQ_TESTMIDI		_IOW ('Q', 8, int)
1041638Srgrimes#define SNDCTL_SEQ_RESETSAMPLES		_IOW ('Q', 9, int)
1051638Srgrimes#define SNDCTL_SEQ_NRSYNTHS		_IOR ('Q',10, int)
1061638Srgrimes#define SNDCTL_SEQ_NRMIDIS		_IOR ('Q',11, int)
1071638Srgrimes#define SNDCTL_MIDI_INFO		_IOWR('Q',12, struct midi_info)
1081638Srgrimes#define SNDCTL_SEQ_TRESHOLD		_IOW ('Q',13, int)
1091638Srgrimes#define SNDCTL_SYNTH_MEMAVL		_IOWR('Q',14, int)	/* in=dev#, out=memsize */
1101638Srgrimes#define SNDCTL_FM_4OP_ENABLE		_IOW ('Q',15, int)	/* in=dev# */
1111638Srgrimes#define SNDCTL_PMGR_ACCESS		_IOWR('Q',16, struct patmgr_info)
1121638Srgrimes#define SNDCTL_SEQ_PANIC		_IO  ('Q',17)
1131638Srgrimes#define SNDCTL_SEQ_OUTOFBAND		_IOW ('Q',18, struct seq_event_rec)
1141638Srgrimes
1151638Srgrimes	struct seq_event_rec {
1161638Srgrimes			unsigned char arr[8];
1171638Srgrimes		};
1181638Srgrimes
1191638Srgrimes#define SNDCTL_TMR_TIMEBASE		_IOWR('T', 1, int)
1201638Srgrimes#define SNDCTL_TMR_START		_IO  ('T', 2)
1211638Srgrimes#define SNDCTL_TMR_STOP			_IO  ('T', 3)
1221638Srgrimes#define SNDCTL_TMR_CONTINUE		_IO  ('T', 4)
1231638Srgrimes#define SNDCTL_TMR_TEMPO		_IOWR('T', 5, int)
1241638Srgrimes#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 propably too limited.
139 */
140
141struct 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
222struct 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
256struct 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 recognised 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
472typedef unsigned char sbi_instr_data[32];
473
474struct 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
483struct 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
508struct sound_timer_info {
509		char name[30];
510		int caps;
511	};
512
513#define MIDI_CAP_MPU401		1		/* MPU-401 intelligent mode */
514
515struct 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 */
526typedef 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 */
571typedef 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
607typedef 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
619typedef 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
627typedef 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 inpractical 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
853void 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 syncronization 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