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