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