1#ifndef SOUNDCARD_H 2#define SOUNDCARD_H 3/* 4 **************************************************************************** 5 * Copyright by 4Front Technologies 1993-2006 6 * 7 ****************************************************************************** 8 * Modifications to this file are NOT allowed. This header file controls the 9 * OSS API. For compatibility reasons only 4Front Technologies can make changes 10 * to the definitions. If you have any questions, please contact 11 * hannu@opensound.com. 12 ****************************************************************************** 13 * 14 * Redistribution and use in source and binary forms, without 15 * modification, are permitted provided that the following conditions are 16 * met: 1. Redistributions of source code must retain the above copyright 17 * notice, this list of conditions and the following disclaimer. 2. 18 * Redistributions in binary form must reproduce the above copyright notice, 19 * this list of conditions and the following disclaimer in the documentation 20 * and/or other materials provided with the distribution. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND ANY 23 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 24 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 25 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR 26 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 28 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 29 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32 * SUCH DAMAGE. 33 **************************************************************************** 34 */ 35/* 36 * Purpose: The C/C++ header file that defines the OSS API. 37 * Description: 38 * This header file contains all the declarations required to compile OSS 39 * programs. The latest version is always installed together with OSS 40 * use of the latest version is strongly recommended. 41 * 42 * {!notice This header file contains many obsolete definitions 43 * (for compatibility with older applications that still ned them). 44 * Do not use this file as a reference manual of OSS. 45 * Please check the OSS Programmer's guide for descriptions 46 * of the supported API details (http://www.opensound.com/pguide).} 47 */ 48 49#if defined(__cplusplus) 50#define EXTERNC extern "C" 51#else 52#define EXTERNC extern 53#endif /* EXTERN_C_WRAPPERS */ 54 55#define OSS_VERSION 0x040002 56 57#define SOUND_VERSION OSS_VERSION 58#define OPEN_SOUND_SYSTEM 59 60#if defined(__hpux) && !defined(_HPUX_SOURCE) 61# error "-D_HPUX_SOURCE must be used when compiling OSS applications" 62#endif 63 64#ifdef __hpux 65#include <sys/ioctl.h> 66#endif 67 68#ifdef linux 69/* In Linux we need to be prepared for cross compiling */ 70#include <linux/ioctl.h> 71#else 72# ifdef __FreeBSD__ 73# include <sys/ioccom.h> 74# else 75# include <sys/ioctl.h> 76# endif 77#endif 78 79#ifndef __SIOWR 80#if defined(__hpux) || (defined(_IOWR) && (defined(_AIX) || (!defined(sun) && !defined(sparc) && !defined(__INCioctlh) && !defined(__Lynx__)))) 81 82/* 83 * Make sure the ioctl macros are compatible with the ones already used 84 * by this operating system. 85 */ 86#define SIOCPARM_MASK IOCPARM_MASK 87#define SIOC_VOID IOC_VOID 88#define SIOC_OUT IOC_OUT 89#define SIOC_IN IOC_IN 90#define SIOC_INOUT IOC_INOUT 91#define __SIOC_SIZE _IOC_SIZE 92#define __SIOC_DIR _IOC_DIR 93#define __SIOC_NONE _IOC_NONE 94#define __SIOC_READ _IOC_READ 95#define __SIOC_WRITE _IOC_WRITE 96#define __SIO _IO 97#define __SIOR _IOR 98#define __SIOW _IOW 99#define __SIOWR _IOWR 100#else 101 102/* #define SIOCTYPE (0xff<<8) */ 103#define SIOCPARM_MASK 0x1fff /* parameters must be < 8192 bytes */ 104#define SIOC_VOID 0x00000000 /* no parameters */ 105#define SIOC_OUT 0x20000000 /* copy out parameters */ 106#define SIOC_IN 0x40000000 /* copy in parameters */ 107#define SIOC_INOUT (SIOC_IN|SIOC_OUT) 108 109#define __SIO(x,y) ((int)(SIOC_VOID|(x<<8)|y)) 110#define __SIOR(x,y,t) ((int)(SIOC_OUT|((sizeof(t)&SIOCPARM_MASK)<<16)|(x<<8)|y)) 111#define __SIOW(x,y,t) ((int)(SIOC_IN|((sizeof(t)&SIOCPARM_MASK)<<16)|(x<<8)|y)) 112#define __SIOWR(x,y,t) ((int)(SIOC_INOUT|((sizeof(t)&SIOCPARM_MASK)<<16)|(x<<8)|y)) 113#define __SIOC_SIZE(x) ((x>>16)&SIOCPARM_MASK) 114#define __SIOC_DIR(x) (x & 0xf0000000) 115#define __SIOC_NONE SIOC_VOID 116#define __SIOC_READ SIOC_OUT 117#define __SIOC_WRITE SIOC_IN 118# endif /* _IOWR */ 119#endif /* !__SIOWR */ 120 121#define OSS_LONGNAME_SIZE 64 122#define OSS_LABEL_SIZE 16 123#define OSS_DEVNODE_SIZE 32 124typedef char oss_longname_t[OSS_LONGNAME_SIZE]; 125typedef char oss_label_t[OSS_LABEL_SIZE]; 126typedef char oss_devnode_t[OSS_DEVNODE_SIZE]; 127 128#ifndef DISABLE_SEQUENCER 129/* 130 **************************************************************************** 131 * IOCTL Commands for /dev/sequencer and /dev/music (AKA /dev/sequencer2) 132 * 133 * Note that this interface is obsolete and no longer developed. New 134 * applications should use /dev/midi instead. 135 ****************************************************************************/ 136#define SNDCTL_SEQ_RESET __SIO ('Q', 0) 137#define SNDCTL_SEQ_SYNC __SIO ('Q', 1) 138#define SNDCTL_SYNTH_INFO __SIOWR('Q', 2, struct synth_info) 139#define SNDCTL_SEQ_CTRLRATE __SIOWR('Q', 3, int) /* Set/get timer resolution (HZ) */ 140#define SNDCTL_SEQ_GETOUTCOUNT __SIOR ('Q', 4, int) 141#define SNDCTL_SEQ_GETINCOUNT __SIOR ('Q', 5, int) 142#define SNDCTL_SEQ_PERCMODE __SIOW ('Q', 6, int) 143#define SNDCTL_FM_LOAD_INSTR __SIOW ('Q', 7, struct sbi_instrument) /* Obsolete. Don't use!!!!!! */ 144#define SNDCTL_SEQ_TESTMIDI __SIOW ('Q', 8, int) 145#define SNDCTL_SEQ_RESETSAMPLES __SIOW ('Q', 9, int) 146#define SNDCTL_SEQ_NRSYNTHS __SIOR ('Q',10, int) 147#define SNDCTL_SEQ_NRMIDIS __SIOR ('Q',11, int) 148#define SNDCTL_MIDI_INFO __SIOWR('Q',12, struct midi_info) /* OBSOLETE - use SNDCTL_MIDIINFO instead */ 149#define SNDCTL_SEQ_THRESHOLD __SIOW ('Q',13, int) 150#define SNDCTL_SYNTH_MEMAVL __SIOWR('Q',14, int) /* in=dev#, out=memsize */ 151#define SNDCTL_FM_4OP_ENABLE __SIOW ('Q',15, int) /* in=dev# */ 152#define SNDCTL_SEQ_PANIC __SIO ('Q',17) 153#define SNDCTL_SEQ_OUTOFBAND __SIOW ('Q',18, struct seq_event_rec) 154#define SNDCTL_SEQ_GETTIME __SIOR ('Q',19, int) 155#define SNDCTL_SYNTH_ID __SIOWR('Q',20, struct synth_info) 156#define SNDCTL_SYNTH_CONTROL __SIOWR('Q',21, struct synth_control) 157#define SNDCTL_SYNTH_REMOVESAMPLE __SIOWR('Q',22, struct remove_sample) /* Reserved for future use */ 158#define SNDCTL_SEQ_TIMING_ENABLE __SIO ('Q', 23) /* Enable incoming MIDI timing messages */ 159#define SNDCTL_SEQ_ACTSENSE_ENABLE __SIO ('Q', 24) /* Enable incoming active sensing messages */ 160#define SNDCTL_SEQ_RT_ENABLE __SIO ('Q', 25) /* Enable other incoming realtime messages */ 161 162typedef struct synth_control 163{ 164 int devno; /* Synthesizer # */ 165 char data[4000]; /* Device spesific command/data record */ 166} synth_control; 167 168typedef struct remove_sample 169{ 170 int devno; /* Synthesizer # */ 171 int bankno; /* MIDI bank # (0=General MIDI) */ 172 int instrno; /* MIDI instrument number */ 173} remove_sample; 174 175typedef struct seq_event_rec 176{ 177 unsigned char arr[8]; 178} seq_event_rec; 179 180#define SNDCTL_TMR_TIMEBASE __SIOWR('T', 1, int) 181#define SNDCTL_TMR_START __SIO ('T', 2) 182#define SNDCTL_TMR_STOP __SIO ('T', 3) 183#define SNDCTL_TMR_CONTINUE __SIO ('T', 4) 184#define SNDCTL_TMR_TEMPO __SIOWR('T', 5, int) 185#define SNDCTL_TMR_SOURCE __SIOWR('T', 6, int) 186# define TMR_INTERNAL 0x00000001 187# define TMR_EXTERNAL 0x00000002 188# define TMR_MODE_MIDI 0x00000010 189# define TMR_MODE_FSK 0x00000020 190# define TMR_MODE_CLS 0x00000040 191# define TMR_MODE_SMPTE 0x00000080 192#define SNDCTL_TMR_METRONOME __SIOW ('T', 7, int) 193#define SNDCTL_TMR_SELECT __SIOW ('T', 8, int) 194 195/* 196 * Sample loading mechanism for internal synthesizers (/dev/sequencer) 197 * (for the .PAT format). 198 */ 199 200struct patch_info 201{ 202 unsigned short key; /* Use WAVE_PATCH here */ 203#define WAVE_PATCH _PATCHKEY(0x04) 204#define GUS_PATCH WAVE_PATCH 205#define WAVEFRONT_PATCH _PATCHKEY(0x06) 206 207 short device_no; /* Synthesizer number */ 208 short instr_no; /* Midi pgm# */ 209 210 unsigned int mode; 211/* 212 * The least significant byte has the same format than the GUS .PAT 213 * files 214 */ 215#define WAVE_16_BITS 0x01 /* bit 0 = 8 or 16 bit wave data. */ 216#define WAVE_UNSIGNED 0x02 /* bit 1 = Signed - Unsigned data. */ 217#define WAVE_LOOPING 0x04 /* bit 2 = looping enabled-1. */ 218#define WAVE_BIDIR_LOOP 0x08 /* bit 3 = Set is bidirectional looping. */ 219#define WAVE_LOOP_BACK 0x10 /* bit 4 = Set is looping backward. */ 220#define WAVE_SUSTAIN_ON 0x20 /* bit 5 = Turn sustaining on. (Env. pts. 3) */ 221#define WAVE_ENVELOPES 0x40 /* bit 6 = Enable envelopes - 1 */ 222#define WAVE_FAST_RELEASE 0x80 /* bit 7 = Shut off immediately after note off */ 223 /* (use the env_rate/env_offs fields). */ 224/* Linux specific bits */ 225#define WAVE_VIBRATO 0x00010000 /* The vibrato info is valid */ 226#define WAVE_TREMOLO 0x00020000 /* The tremolo info is valid */ 227#define WAVE_SCALE 0x00040000 /* The scaling info is valid */ 228#define WAVE_FRACTIONS 0x00080000 /* Fraction information is valid */ 229/* Reserved bits */ 230#define WAVE_ROM 0x40000000 /* For future use */ 231#define WAVE_MULAW 0x20000000 /* For future use */ 232/* Other bits must be zeroed */ 233 234 int len; /* Size of the wave data in bytes */ 235 int loop_start, loop_end; /* Byte offsets from the beginning */ 236 237/* 238 * The base_freq and base_note fields are used when computing the 239 * playback speed for a note. The base_note defines the tone frequency 240 * which is heard if the sample is played using the base_freq as the 241 * playback speed. 242 * 243 * The low_note and high_note fields define the minimum and maximum note 244 * frequencies for which this sample is valid. It is possible to define 245 * more than one samples for an instrument number at the same time. The 246 * low_note and high_note fields are used to select the most suitable one. 247 * 248 * The fields base_note, high_note and low_note should contain 249 * the note frequency multiplied by 1000. For example value for the 250 * middle A is 440*1000. 251 */ 252 253 unsigned int base_freq; 254 unsigned int base_note; 255 unsigned int high_note; 256 unsigned int low_note; 257 int panning; /* -128=left, 127=right */ 258 int detuning; 259 260 /* Envelope. Enabled by mode bit WAVE_ENVELOPES */ 261 unsigned char env_rate[6]; /* GUS HW ramping rate */ 262 unsigned char env_offset[6]; /* 255 == 100% */ 263 264 /* 265 * The tremolo, vibrato and scale info are not supported yet. 266 * Enable by setting the mode bits WAVE_TREMOLO, WAVE_VIBRATO or 267 * WAVE_SCALE 268 */ 269 270 unsigned char tremolo_sweep; 271 unsigned char tremolo_rate; 272 unsigned char tremolo_depth; 273 274 unsigned char vibrato_sweep; 275 unsigned char vibrato_rate; 276 unsigned char vibrato_depth; 277 278 int scale_frequency; 279 unsigned int scale_factor; /* from 0 to 2048 or 0 to 2 */ 280 281 int volume; 282 int fractions; 283 int reserved1; 284 int spare[2]; 285 char data[1]; /* The waveform data starts here */ 286}; 287 288struct sysex_info 289{ 290 short key; /* Use SYSEX_PATCH or MAUI_PATCH here */ 291#define SYSEX_PATCH _PATCHKEY(0x05) 292#define MAUI_PATCH _PATCHKEY(0x06) 293 short device_no; /* Synthesizer number */ 294 int len; /* Size of the sysex data in bytes */ 295 unsigned char data[1]; /* Sysex data starts here */ 296}; 297 298/* 299 * /dev/sequencer input events. 300 * 301 * The data written to the /dev/sequencer is a stream of events. Events 302 * are records of 4 or 8 bytes. The first byte defines the size. 303 * Any number of events can be written with a write call. There 304 * is a set of macros for sending these events. Use these macros if you 305 * want to maximize portability of your program. 306 * 307 * Events SEQ_WAIT, SEQ_MIDIPUTC and SEQ_ECHO. Are also input events. 308 * (All input events are currently 4 bytes long. Be prepared to support 309 * 8 byte events also. If you receive any event having first byte >= 128, 310 * it's a 8 byte event. 311 * 312 * The events are documented at the end of this file. 313 * 314 * Normal events (4 bytes) 315 * There is also a 8 byte version of most of the 4 byte events. The 316 * 8 byte one is recommended. 317 * 318 * NOTE! All 4 byte events are now obsolete. Applications should not write 319 * them. However 4 byte events are still used as inputs from 320 * /dev/sequencer (/dev/music uses only 8 byte ones). 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#define SEQ_BALANCE 11 337#define SEQ_VOLMODE 12 338 339/************************************ 340 * Midi controller numbers * 341 ************************************/ 342/* 343 * Controllers 0 to 31 (0x00 to 0x1f) and 344 * 32 to 63 (0x20 to 0x3f) are continuous 345 * controllers. 346 * In the MIDI 1.0 these controllers are sent using 347 * two messages. Controller numbers 0 to 31 are used 348 * to send the MSB and the controller numbers 32 to 63 349 * are for the LSB. Note that just 7 bits are used in MIDI bytes. 350 */ 351 352#define CTL_BANK_SELECT 0x00 353#define CTL_MODWHEEL 0x01 354#define CTL_BREATH 0x02 355/* undefined 0x03 */ 356#define CTL_FOOT 0x04 357#define CTL_PORTAMENTO_TIME 0x05 358#define CTL_DATA_ENTRY 0x06 359#define CTL_MAIN_VOLUME 0x07 360#define CTL_BALANCE 0x08 361/* undefined 0x09 */ 362#define CTL_PAN 0x0a 363#define CTL_EXPRESSION 0x0b 364/* undefined 0x0c */ 365/* undefined 0x0d */ 366/* undefined 0x0e */ 367/* undefined 0x0f */ 368#define CTL_GENERAL_PURPOSE1 0x10 369#define CTL_GENERAL_PURPOSE2 0x11 370#define CTL_GENERAL_PURPOSE3 0x12 371#define CTL_GENERAL_PURPOSE4 0x13 372/* undefined 0x14 - 0x1f */ 373 374/* undefined 0x20 */ 375/* The controller numbers 0x21 to 0x3f are reserved for the */ 376/* least significant bytes of the controllers 0x00 to 0x1f. */ 377/* These controllers are not recognised by the driver. */ 378 379/* Controllers 64 to 69 (0x40 to 0x45) are on/off switches. */ 380/* 0=OFF and 127=ON (intermediate values are possible) */ 381#define CTL_DAMPER_PEDAL 0x40 382#define CTL_SUSTAIN 0x40 /* Alias */ 383#define CTL_HOLD 0x40 /* Alias */ 384#define CTL_PORTAMENTO 0x41 385#define CTL_SOSTENUTO 0x42 386#define CTL_SOFT_PEDAL 0x43 387/* undefined 0x44 */ 388#define CTL_HOLD2 0x45 389/* undefined 0x46 - 0x4f */ 390 391#define CTL_GENERAL_PURPOSE5 0x50 392#define CTL_GENERAL_PURPOSE6 0x51 393#define CTL_GENERAL_PURPOSE7 0x52 394#define CTL_GENERAL_PURPOSE8 0x53 395/* undefined 0x54 - 0x5a */ 396#define CTL_EXT_EFF_DEPTH 0x5b 397#define CTL_TREMOLO_DEPTH 0x5c 398#define CTL_CHORUS_DEPTH 0x5d 399#define CTL_DETUNE_DEPTH 0x5e 400#define CTL_CELESTE_DEPTH 0x5e /* Alias for the above one */ 401#define CTL_PHASER_DEPTH 0x5f 402#define CTL_DATA_INCREMENT 0x60 403#define CTL_DATA_DECREMENT 0x61 404#define CTL_NONREG_PARM_NUM_LSB 0x62 405#define CTL_NONREG_PARM_NUM_MSB 0x63 406#define CTL_REGIST_PARM_NUM_LSB 0x64 407#define CTL_REGIST_PARM_NUM_MSB 0x65 408/* undefined 0x66 - 0x78 */ 409/* reserved 0x79 - 0x7f */ 410 411/* Pseudo controllers (not midi compatible) */ 412#define CTRL_PITCH_BENDER 255 413#define CTRL_PITCH_BENDER_RANGE 254 414#define CTRL_EXPRESSION 253 /* Obsolete */ 415#define CTRL_MAIN_VOLUME 252 /* Obsolete */ 416 417/* 418 * Volume mode defines how volumes are used 419 */ 420 421#define VOL_METHOD_ADAGIO 1 422#define VOL_METHOD_LINEAR 2 423 424/* 425 * Note! SEQ_WAIT, SEQ_MIDIPUTC and SEQ_ECHO are used also as 426 * input events. 427 */ 428 429/* 430 * Event codes 0xf0 to 0xfc are reserved for future extensions. 431 */ 432 433#define SEQ_FULLSIZE 0xfd /* Long events */ 434/* 435 * SEQ_FULLSIZE events are used for loading patches/samples to the 436 * synthesizer devices. These events are passed directly to the driver 437 * of the associated synthesizer device. There is no limit to the size 438 * of the extended events. These events are not queued but executed 439 * immediately when the write() is called (execution can take several 440 * seconds of time). 441 * 442 * When a SEQ_FULLSIZE message is written to the device, it must 443 * be written using exactly one write() call. Other events cannot 444 * be mixed to the same write. 445 * 446 * For FM synths (YM3812/OPL3) use struct sbi_instrument and write it to the 447 * /dev/sequencer. Don't write other data together with the instrument structure 448 * Set the key field of the structure to FM_PATCH. The device field is used to 449 * route the patch to the corresponding device. 450 * 451 * For wave table use struct patch_info. Initialize the key field 452 * to WAVE_PATCH. 453 */ 454#define SEQ_PRIVATE 0xfe /* Low level HW dependent events (8 bytes) */ 455#define SEQ_EXTENDED 0xff /* Extended events (8 bytes) OBSOLETE */ 456 457/* 458 * Record for FM patches 459 */ 460 461typedef unsigned char sbi_instr_data[32]; 462 463struct sbi_instrument 464{ 465 unsigned short key; /* FM_PATCH or OPL3_PATCH */ 466#define FM_PATCH _PATCHKEY(0x01) 467#define OPL3_PATCH _PATCHKEY(0x03) 468 short device; /* Synth# (0-4) */ 469 int channel; /* Program# to be initialized */ 470 sbi_instr_data operators; /* Register settings for operator cells (.SBI format) */ 471}; 472 473struct synth_info 474{ /* Read only */ 475 char name[30]; 476 int device; /* 0-N. INITIALIZE BEFORE CALLING */ 477 int synth_type; 478#define SYNTH_TYPE_FM 0 479#define SYNTH_TYPE_SAMPLE 1 480#define SYNTH_TYPE_MIDI 2 /* Midi interface */ 481 482 int synth_subtype; 483#define FM_TYPE_ADLIB 0x00 484#define FM_TYPE_OPL3 0x01 485#define MIDI_TYPE_MPU401 0x401 486 487#define SAMPLE_TYPE_BASIC 0x10 488#define SAMPLE_TYPE_GUS SAMPLE_TYPE_BASIC 489#define SAMPLE_TYPE_WAVEFRONT 0x11 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 int 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 502struct sound_timer_info 503{ 504 char name[32]; 505 int caps; 506}; 507 508struct midi_info /* OBSOLETE */ 509{ 510 char name[30]; 511 int device; /* 0-N. INITIALIZE BEFORE CALLING */ 512 unsigned int capabilities; /* To be defined later */ 513 int dev_type; 514 int dummies[18]; /* Reserve space */ 515}; 516 517/* 518 * Level 2 event types for /dev/sequencer 519 */ 520 521/* 522 * The 4 most significant bits of byte 0 specify the class of 523 * the event: 524 * 525 * 0x8X = system level events, 526 * 0x9X = device/port specific events, event[1] = device/port, 527 * The last 4 bits give the subtype: 528 * 0x02 = Channel event (event[3] = chn). 529 * 0x01 = note event (event[4] = note). 530 * (0x01 is not used alone but always with bit 0x02). 531 * event[2] = MIDI message code (0x80=note off etc.) 532 * 533 */ 534 535#define EV_SEQ_LOCAL 0x80 536#define EV_TIMING 0x81 537#define EV_CHN_COMMON 0x92 538#define EV_CHN_VOICE 0x93 539#define EV_SYSEX 0x94 540#define EV_SYSTEM 0x95 /* MIDI system and real time messages (input only) */ 541/* 542 * Event types 200 to 220 are reserved for application use. 543 * These numbers will not be used by the driver. 544 */ 545 546/* 547 * Events for event type EV_CHN_VOICE 548 */ 549 550#define MIDI_NOTEOFF 0x80 551#define MIDI_NOTEON 0x90 552#define MIDI_KEY_PRESSURE 0xA0 553 554/* 555 * Events for event type EV_CHN_COMMON 556 */ 557 558#define MIDI_CTL_CHANGE 0xB0 559#define MIDI_PGM_CHANGE 0xC0 560#define MIDI_CHN_PRESSURE 0xD0 561#define MIDI_PITCH_BEND 0xE0 562 563#define MIDI_SYSTEM_PREFIX 0xF0 564 565/* 566 * Timer event types 567 */ 568#define TMR_WAIT_REL 1 /* Time relative to the prev time */ 569#define TMR_WAIT_ABS 2 /* Absolute time since TMR_START */ 570#define TMR_STOP 3 571#define TMR_START 4 572#define TMR_CONTINUE 5 573#define TMR_TEMPO 6 574#define TMR_ECHO 8 575#define TMR_CLOCK 9 /* MIDI clock */ 576#define TMR_SPP 10 /* Song position pointer */ 577#define TMR_TIMESIG 11 /* Time signature */ 578 579/* 580 * Local event types 581 */ 582#define LOCL_STARTAUDIO 1 583#define LOCL_STARTAUDIO2 2 584#define LOCL_STARTAUDIO3 3 585#define LOCL_STARTAUDIO4 4 586 587#if (!defined(__KERNEL__) && !defined(KERNEL) && !defined(INKERNEL) && !defined(_KERNEL)) || defined(USE_SEQ_MACROS) 588/* 589 * Some convenience macros to simplify programming of the 590 * /dev/sequencer interface 591 * 592 * These macros define the API which should be used when possible. 593 */ 594#define SEQ_DECLAREBUF() SEQ_USE_EXTBUF() 595 596void seqbuf_dump (void); /* This function must be provided by programs */ 597 598EXTERNC int OSS_init (int seqfd, int buflen); 599EXTERNC void OSS_seqbuf_dump (int fd, unsigned char *buf, int buflen); 600EXTERNC void OSS_seq_advbuf (int len, int fd, unsigned char *buf, int buflen); 601EXTERNC void OSS_seq_needbuf (int len, int fd, unsigned char *buf, 602 int buflen); 603EXTERNC void OSS_patch_caching (int dev, int chn, int patch, int fd, 604 unsigned char *buf, int buflen); 605EXTERNC void OSS_drum_caching (int dev, int chn, int patch, int fd, 606 unsigned char *buf, int buflen); 607EXTERNC void OSS_write_patch (int fd, unsigned char *buf, int len); 608EXTERNC int OSS_write_patch2 (int fd, unsigned char *buf, int len); 609 610#define SEQ_PM_DEFINES int __foo_bar___ 611#ifdef OSSLIB 612# define SEQ_USE_EXTBUF() \ 613 EXTERNC unsigned char *_seqbuf; \ 614 EXTERNC int _seqbuflen;EXTERNC int _seqbufptr 615# define SEQ_DEFINEBUF(len) SEQ_USE_EXTBUF();static int _requested_seqbuflen=len 616# define _SEQ_ADVBUF(len) OSS_seq_advbuf(len, seqfd, _seqbuf, _seqbuflen) 617# define _SEQ_NEEDBUF(len) OSS_seq_needbuf(len, seqfd, _seqbuf, _seqbuflen) 618# define SEQ_DUMPBUF() OSS_seqbuf_dump(seqfd, _seqbuf, _seqbuflen) 619 620# define SEQ_LOAD_GMINSTR(dev, instr) \ 621 OSS_patch_caching(dev, -1, instr, seqfd, _seqbuf, _seqbuflen) 622# define SEQ_LOAD_GMDRUM(dev, drum) \ 623 OSS_drum_caching(dev, -1, drum, seqfd, _seqbuf, _seqbuflen) 624#else /* !OSSLIB */ 625 626# define SEQ_LOAD_GMINSTR(dev, instr) 627# define SEQ_LOAD_GMDRUM(dev, drum) 628 629# define SEQ_USE_EXTBUF() \ 630 EXTERNC unsigned char _seqbuf[]; \ 631 EXTERNC int _seqbuflen;EXTERNC int _seqbufptr 632 633#ifndef USE_SIMPLE_MACROS 634/* Sample seqbuf_dump() implementation: 635 * 636 * SEQ_DEFINEBUF (2048); -- Defines a buffer for 2048 bytes 637 * 638 * int seqfd; -- The file descriptor for /dev/sequencer. 639 * 640 * void 641 * seqbuf_dump () 642 * { 643 * if (_seqbufptr) 644 * if (write (seqfd, _seqbuf, _seqbufptr) == -1) 645 * { 646 * perror ("write /dev/sequencer"); 647 * exit (-1); 648 * } 649 * _seqbufptr = 0; 650 * } 651 */ 652 653#define SEQ_DEFINEBUF(len) \ 654 unsigned char _seqbuf[len]; int _seqbuflen = len;int _seqbufptr = 0 655#define _SEQ_NEEDBUF(len) \ 656 if ((_seqbufptr+(len)) > _seqbuflen) seqbuf_dump() 657#define _SEQ_ADVBUF(len) _seqbufptr += len 658#define SEQ_DUMPBUF seqbuf_dump 659#else 660/* 661 * This variation of the sequencer macros is used just to format one event 662 * using fixed buffer. 663 * 664 * The program using the macro library must define the following macros before 665 * using this library. 666 * 667 * #define _seqbuf name of the buffer (unsigned char[]) 668 * #define _SEQ_ADVBUF(len) If the applic needs to know the exact 669 * size of the event, this macro can be used. 670 * Otherwise this must be defined as empty. 671 * #define _seqbufptr Define the name of index variable or 0 if 672 * not required. 673 */ 674#define _SEQ_NEEDBUF(len) /* empty */ 675#endif 676#endif /* !OSSLIB */ 677 678#define SEQ_VOLUME_MODE(dev, mode) \ 679 {_SEQ_NEEDBUF(8);\ 680 _seqbuf[_seqbufptr] = SEQ_EXTENDED;\ 681 _seqbuf[_seqbufptr+1] = SEQ_VOLMODE;\ 682 _seqbuf[_seqbufptr+2] = (dev);\ 683 _seqbuf[_seqbufptr+3] = (mode);\ 684 _seqbuf[_seqbufptr+4] = 0;\ 685 _seqbuf[_seqbufptr+5] = 0;\ 686 _seqbuf[_seqbufptr+6] = 0;\ 687 _seqbuf[_seqbufptr+7] = 0;\ 688 _SEQ_ADVBUF(8);} 689 690/* 691 * Midi voice messages 692 */ 693 694#define _CHN_VOICE(dev, event, chn, note, parm) \ 695 {_SEQ_NEEDBUF(8);\ 696 _seqbuf[_seqbufptr] = EV_CHN_VOICE;\ 697 _seqbuf[_seqbufptr+1] = (dev);\ 698 _seqbuf[_seqbufptr+2] = (event);\ 699 _seqbuf[_seqbufptr+3] = (chn);\ 700 _seqbuf[_seqbufptr+4] = (note);\ 701 _seqbuf[_seqbufptr+5] = (parm);\ 702 _seqbuf[_seqbufptr+6] = (0);\ 703 _seqbuf[_seqbufptr+7] = 0;\ 704 _SEQ_ADVBUF(8);} 705 706#define SEQ_START_NOTE(dev, chn, note, vol) \ 707 _CHN_VOICE(dev, MIDI_NOTEON, chn, note, vol) 708 709#define SEQ_STOP_NOTE(dev, chn, note, vol) \ 710 _CHN_VOICE(dev, MIDI_NOTEOFF, chn, note, vol) 711 712#define SEQ_KEY_PRESSURE(dev, chn, note, pressure) \ 713 _CHN_VOICE(dev, MIDI_KEY_PRESSURE, chn, note, pressure) 714 715/* 716 * Midi channel messages 717 */ 718 719#define _CHN_COMMON(dev, event, chn, p1, p2, w14) \ 720 {_SEQ_NEEDBUF(8);\ 721 _seqbuf[_seqbufptr] = EV_CHN_COMMON;\ 722 _seqbuf[_seqbufptr+1] = (dev);\ 723 _seqbuf[_seqbufptr+2] = (event);\ 724 _seqbuf[_seqbufptr+3] = (chn);\ 725 _seqbuf[_seqbufptr+4] = (p1);\ 726 _seqbuf[_seqbufptr+5] = (p2);\ 727 *(short *)&_seqbuf[_seqbufptr+6] = (w14);\ 728 _SEQ_ADVBUF(8);} 729/* 730 * SEQ_SYSEX permits sending of sysex messages. (It may look that it permits 731 * sending any MIDI bytes but it's absolutely not possible. Trying to do 732 * so _will_ cause problems with MPU401 intelligent mode). 733 * 734 * Sysex messages are sent in blocks of 1 to 6 bytes. Longer messages must be 735 * sent by calling SEQ_SYSEX() several times (there must be no other events 736 * between them). First sysex fragment must have 0xf0 in the first byte 737 * and the last byte (buf[len-1] of the last fragment must be 0xf7. No byte 738 * between these sysex start and end markers cannot be larger than 0x7f. Also 739 * lengths of each fragments (except the last one) must be 6. 740 * 741 * Breaking the above rules may work with some MIDI ports but is likely to 742 * cause fatal problems with some other devices (such as MPU401). 743 */ 744#define SEQ_SYSEX(dev, buf, len) \ 745 {int ii, ll=(len); \ 746 unsigned char *bufp=buf;\ 747 if (ll>6)ll=6;\ 748 _SEQ_NEEDBUF(8);\ 749 _seqbuf[_seqbufptr] = EV_SYSEX;\ 750 _seqbuf[_seqbufptr+1] = (dev);\ 751 for(ii=0;ii<ll;ii++)\ 752 _seqbuf[_seqbufptr+ii+2] = bufp[ii];\ 753 for(ii=ll;ii<6;ii++)\ 754 _seqbuf[_seqbufptr+ii+2] = 0xff;\ 755 _SEQ_ADVBUF(8);} 756 757#define SEQ_CHN_PRESSURE(dev, chn, pressure) \ 758 _CHN_COMMON(dev, MIDI_CHN_PRESSURE, chn, pressure, 0, 0) 759 760#define SEQ_SET_PATCH SEQ_PGM_CHANGE 761#ifdef OSSLIB 762# define SEQ_PGM_CHANGE(dev, chn, patch) \ 763 {OSS_patch_caching(dev, chn, patch, seqfd, _seqbuf, _seqbuflen); \ 764 _CHN_COMMON(dev, MIDI_PGM_CHANGE, chn, patch, 0, 0);} 765#else 766# define SEQ_PGM_CHANGE(dev, chn, patch) \ 767 _CHN_COMMON(dev, MIDI_PGM_CHANGE, chn, patch, 0, 0) 768#endif 769 770#define SEQ_CONTROL(dev, chn, controller, value) \ 771 _CHN_COMMON(dev, MIDI_CTL_CHANGE, chn, controller, 0, value) 772 773#define SEQ_BENDER(dev, chn, value) \ 774 _CHN_COMMON(dev, MIDI_PITCH_BEND, chn, 0, 0, value) 775 776#define SEQ_V2_X_CONTROL(dev, voice, controller, value) \ 777 {_SEQ_NEEDBUF(8);\ 778 _seqbuf[_seqbufptr] = SEQ_EXTENDED;\ 779 _seqbuf[_seqbufptr+1] = SEQ_CONTROLLER;\ 780 _seqbuf[_seqbufptr+2] = (dev);\ 781 _seqbuf[_seqbufptr+3] = (voice);\ 782 _seqbuf[_seqbufptr+4] = (controller);\ 783 _seqbuf[_seqbufptr+5] = ((value)&0xff);\ 784 _seqbuf[_seqbufptr+6] = ((value>>8)&0xff);\ 785 _seqbuf[_seqbufptr+7] = 0;\ 786 _SEQ_ADVBUF(8);} 787/* 788 * The following 5 macros are incorrectly implemented and obsolete. 789 * Use SEQ_BENDER and SEQ_CONTROL (with proper controller) instead. 790 */ 791#define SEQ_PITCHBEND(dev, voice, value) \ 792 SEQ_V2_X_CONTROL(dev, voice, CTRL_PITCH_BENDER, value) 793#define SEQ_BENDER_RANGE(dev, voice, value) \ 794 SEQ_V2_X_CONTROL(dev, voice, CTRL_PITCH_BENDER_RANGE, value) 795#define SEQ_EXPRESSION(dev, voice, value) \ 796 SEQ_CONTROL(dev, voice, CTL_EXPRESSION, value*128) 797#define SEQ_MAIN_VOLUME(dev, voice, value) \ 798 SEQ_CONTROL(dev, voice, CTL_MAIN_VOLUME, (value*16383)/100) 799#define SEQ_PANNING(dev, voice, pos) \ 800 SEQ_CONTROL(dev, voice, CTL_PAN, (pos+128) / 2) 801 802/* 803 * Timing and syncronization macros 804 */ 805 806#define _TIMER_EVENT(ev, parm) {_SEQ_NEEDBUF(8);\ 807 _seqbuf[_seqbufptr+0] = EV_TIMING; \ 808 _seqbuf[_seqbufptr+1] = (ev); \ 809 _seqbuf[_seqbufptr+2] = 0;\ 810 _seqbuf[_seqbufptr+3] = 0;\ 811 *(unsigned int *)&_seqbuf[_seqbufptr+4] = (parm); \ 812 _SEQ_ADVBUF(8);} 813 814#define SEQ_START_TIMER() _TIMER_EVENT(TMR_START, 0) 815#define SEQ_STOP_TIMER() _TIMER_EVENT(TMR_STOP, 0) 816#define SEQ_CONTINUE_TIMER() _TIMER_EVENT(TMR_CONTINUE, 0) 817#define SEQ_WAIT_TIME(ticks) _TIMER_EVENT(TMR_WAIT_ABS, ticks) 818#define SEQ_DELTA_TIME(ticks) _TIMER_EVENT(TMR_WAIT_REL, ticks) 819#define SEQ_ECHO_BACK(key) _TIMER_EVENT(TMR_ECHO, key) 820#define SEQ_SET_TEMPO(value) _TIMER_EVENT(TMR_TEMPO, value) 821#define SEQ_SONGPOS(pos) _TIMER_EVENT(TMR_SPP, pos) 822#define SEQ_TIME_SIGNATURE(sig) _TIMER_EVENT(TMR_TIMESIG, sig) 823 824/* 825 * Local control events 826 */ 827 828#define _LOCAL_EVENT(ev, parm) {_SEQ_NEEDBUF(8);\ 829 _seqbuf[_seqbufptr+0] = EV_SEQ_LOCAL; \ 830 _seqbuf[_seqbufptr+1] = (ev); \ 831 _seqbuf[_seqbufptr+2] = 0;\ 832 _seqbuf[_seqbufptr+3] = 0;\ 833 *(unsigned int *)&_seqbuf[_seqbufptr+4] = (parm); \ 834 _SEQ_ADVBUF(8);} 835 836#define SEQ_PLAYAUDIO(devmask) _LOCAL_EVENT(LOCL_STARTAUDIO, devmask) 837#define SEQ_PLAYAUDIO2(devmask) _LOCAL_EVENT(LOCL_STARTAUDIO2, devmask) 838#define SEQ_PLAYAUDIO3(devmask) _LOCAL_EVENT(LOCL_STARTAUDIO3, devmask) 839#define SEQ_PLAYAUDIO4(devmask) _LOCAL_EVENT(LOCL_STARTAUDIO4, devmask) 840/* 841 * Events for the level 1 interface only 842 */ 843 844#define SEQ_MIDIOUT(device, byte) {_SEQ_NEEDBUF(4);\ 845 _seqbuf[_seqbufptr] = SEQ_MIDIPUTC;\ 846 _seqbuf[_seqbufptr+1] = (byte);\ 847 _seqbuf[_seqbufptr+2] = (device);\ 848 _seqbuf[_seqbufptr+3] = 0;\ 849 _SEQ_ADVBUF(4);} 850 851/* 852 * Patch loading. 853 */ 854#ifdef OSSLIB 855# define SEQ_WRPATCH(patchx, len) \ 856 OSS_write_patch(seqfd, (char*)(patchx), len) 857# define SEQ_WRPATCH2(patchx, len) \ 858 OSS_write_patch2(seqfd, (char*)(patchx), len) 859#else 860# define SEQ_WRPATCH(patchx, len) \ 861 {if (_seqbufptr) SEQ_DUMPBUF();\ 862 if (write(seqfd, (char*)(patchx), len)==-1) \ 863 perror("Write patch: /dev/sequencer");} 864# define SEQ_WRPATCH2(patchx, len) \ 865 (SEQ_DUMPBUF(), write(seqfd, (char*)(patchx), len)) 866#endif 867 868#endif 869#endif /* ifndef DISABLE_SEQUENCER */ 870 871/* 872 **************************************************************************** 873 * ioctl commands for the /dev/midi## 874 ****************************************************************************/ 875#define SNDCTL_MIDI_PRETIME __SIOWR('m', 0, int) 876 877#if 0 878/* 879 * The SNDCTL_MIDI_MPUMODE and SNDCTL_MIDI_MPUCMD calls 880 * are completely obsolete. The hardware device (MPU-401 "intelligent mode" 881 * and compatibles) has disappeared from the market 10 years ago so there 882 * is no need for this stuff. The MPU-401 "UART" mode devices don't support 883 * this stuff. 884 */ 885typedef struct 886{ 887 unsigned char cmd; 888 char nr_args, nr_returns; 889 unsigned char data[30]; 890} mpu_command_rec; 891 892#define SNDCTL_MIDI_MPUMODE __SIOWR('m', 1, int) 893#define SNDCTL_MIDI_MPUCMD __SIOWR('m', 2, mpu_command_rec) 894#endif 895 896/* 897 * SNDCTL_MIDI_MTCINPUT turns on a mode where OSS automatically inserts 898 * MTC quarter frame messages (F1 xx) to the input. 899 * The argument is the MTC mode: 900 * 901 * -1 = Turn MTC messages OFF (default) 902 * 24 = 24 FPS 903 * 25 = 25 FPS 904 * 29 = 30 FPS drop frame 905 * 30 = 30 FPS 906 * 907 * Note that 25 FPS mode is probably the only mode that is supported. Other 908 * modes may be supported in the future versions of OSS, 25 FPS is handy 909 * because it generates 25*4=100 quarter frame messages per second which 910 * matches the usual 100 HZ system timer rate). 911 * 912 * The quarter frame timer will be reset to 0:00:00:00.0 at the moment this 913 * ioctl is made. 914 */ 915#define SNDCTL_MIDI_MTCINPUT __SIOWR('m', 3, int) 916 917/* 918 * MTC/SMPTE time code record (for future use) 919 */ 920typedef struct 921{ 922 unsigned char hours, minutes, seconds, frames, qframes; 923 char direction; 924#define MTC_DIR_STOPPED 0 925#define MTC_DIR_FORWARD 1 926#define MTC_DIR_BACKWARD -1 927 unsigned char time_code_type; 928 unsigned int flags; 929} oss_mtc_data_t; 930 931#define SNDCTL_MIDI_SETMODE __SIOWR('m', 6, int) 932# define MIDI_MODE_TRADITIONAL 0 933# define MIDI_MODE_TIMED 1 /* Input times are in MIDI ticks */ 934# define MIDI_MODE_TIMED_ABS 2 /* Input times are absolute (usecs) */ 935 936/* 937 * Packet header for MIDI_MODE_TIMED and MIDI_MODE_TIMED_ABS 938 */ 939typedef unsigned long long oss_midi_time_t; /* Variable type for MIDI time (clock ticks) */ 940 941typedef struct 942{ 943 int magic; /* Initialize to MIDI_HDR_MAGIC */ 944#define MIDI_HDR_MAGIC -1 945 unsigned short event_type; 946#define MIDI_EV_WRITE 0 /* Write or read (with payload) */ 947#define MIDI_EV_TEMPO 1 948#define MIDI_EV_ECHO 2 949#define MIDI_EV_START 3 950#define MIDI_EV_STOP 4 951#define MIDI_EV_CONTINUE 5 952#define MIDI_EV_XPRESSWRITE 6 953#define MIDI_EV_TIMEBASE 7 954#define MIDI_EV_DEVCTL 8 /* Device control read/write */ 955 unsigned short options; 956#define MIDI_OPT_NONE 0x0000 957#define MIDI_OPT_TIMED 0x0001 958#define MIDI_OPT_CONTINUATION 0x0002 959#define MIDI_OPT_USECTIME 0x0004 /* Time is absolute (in usecs) */ 960#define MIDI_OPT_BUSY 0x0008 /* Reserved for internal use */ 961 oss_midi_time_t time; 962 int parm; 963 int filler[3]; /* Fur future expansion - init to zeros */ 964} midi_packet_header_t; 965/* 966 * MIDI_PAYLOAD_SIZE is the maximum size of one MIDI input chunk. It must be 967 * less (or equal) than 1024 which is the read size recommended in the 968 * documentation. TODO: Explain this better. 969 */ 970#define MIDI_PAYLOAD_SIZE 1000 971 972typedef struct 973{ 974 midi_packet_header_t hdr; 975 unsigned char payload[MIDI_PAYLOAD_SIZE]; 976} midi_packet_t; 977 978#define SNDCTL_MIDI_TIMEBASE __SIOWR('m', 7, int) 979#define SNDCTL_MIDI_TEMPO __SIOWR('m', 8, int) 980/* 981 * User land MIDI servers (synths) can use SNDCTL_MIDI_SET_LATENCY 982 * to request MIDI events to be sent to them in advance. The parameter 983 * (in microseconds) tells how much before the events are submitted. 984 * 985 * This feature is only valid for loopback devices and possibly some other 986 * types of virtual devices. 987 */ 988#define SNDCTL_MIDI_SET_LATENCY __SIOW ('m', 9, int) 989/* 990 **************************************************************************** 991 * IOCTL commands for /dev/dsp 992 ****************************************************************************/ 993 994#define SNDCTL_DSP_HALT __SIO ('P', 0) 995#define SNDCTL_DSP_RESET SNDCTL_DSP_HALT /* Old name */ 996#define SNDCTL_DSP_SYNC __SIO ('P', 1) 997#define SNDCTL_DSP_SPEED __SIOWR('P', 2, int) 998 999/* SNDCTL_DSP_STEREO is obsolete - use SNDCTL_DSP_CHANNELS instead */ 1000#define SNDCTL_DSP_STEREO __SIOWR('P', 3, int) 1001/* SNDCTL_DSP_STEREO is obsolete - use SNDCTL_DSP_CHANNELS instead */ 1002 1003#define SNDCTL_DSP_GETBLKSIZE __SIOWR('P', 4, int) 1004#define SNDCTL_DSP_SAMPLESIZE SNDCTL_DSP_SETFMT 1005#define SNDCTL_DSP_CHANNELS __SIOWR('P', 6, int) 1006#define SNDCTL_DSP_POST __SIO ('P', 8) 1007#define SNDCTL_DSP_SUBDIVIDE __SIOWR('P', 9, int) 1008#define SNDCTL_DSP_SETFRAGMENT __SIOWR('P',10, int) 1009 1010/* Audio data formats (Note! U8=8 and S16_LE=16 for compatibility) */ 1011#define SNDCTL_DSP_GETFMTS __SIOR ('P',11, int) /* Returns a mask */ 1012#define SNDCTL_DSP_SETFMT __SIOWR('P',5, int) /* Selects ONE fmt */ 1013# define AFMT_QUERY 0x00000000 /* Return current fmt */ 1014# define AFMT_MU_LAW 0x00000001 1015# define AFMT_A_LAW 0x00000002 1016# define AFMT_IMA_ADPCM 0x00000004 1017# define AFMT_U8 0x00000008 1018# define AFMT_S16_LE 0x00000010 /* Little endian signed 16 */ 1019# define AFMT_S16_BE 0x00000020 /* Big endian signed 16 */ 1020# define AFMT_S8 0x00000040 1021# define AFMT_U16_LE 0x00000080 /* Little endian U16 */ 1022# define AFMT_U16_BE 0x00000100 /* Big endian U16 */ 1023# define AFMT_MPEG 0x00000200 /* MPEG (2) audio */ 1024 1025/* AC3 _compressed_ bitstreams (See Programmer's Guide for details). */ 1026# define AFMT_AC3 0x00000400 1027/* Ogg Vorbis _compressed_ bit streams */ 1028# define AFMT_VORBIS 0x00000800 1029 1030/* 32 bit formats (MSB aligned) formats */ 1031# define AFMT_S32_LE 0x00001000 1032# define AFMT_S32_BE 0x00002000 1033 1034/* Reserved for _native_ endian double precision IEEE floating point */ 1035# define AFMT_FLOAT 0x00004000 1036 1037/* 24 bit formats (LSB aligned in 32 bit word) formats */ 1038# define AFMT_S24_LE 0x00008000 1039# define AFMT_S24_BE 0x00010000 1040 1041/* 1042 * S/PDIF raw format. In this format the S/PDIF frames (including all 1043 * control and user bits) are included in the data stream. Each sample 1044 * is stored in a 32 bit frame (see IEC-958 for more info). This format 1045 * is supported by very few devices and it's only usable for purposes 1046 * where full access to the control/user bits is required (real time control). 1047 */ 1048# define AFMT_SPDIF_RAW 0x00020000 1049 1050/* 24 bit packed (3 byte) little endian format (USB compatibility) */ 1051# define AFMT_S24_PACKED 0x00040000 1052 1053 1054/* 1055 * Some big endian/little endian handling macros (native endian and opposite 1056 * endian formats). The usage of these macros is described in the OSS 1057 * Programmer's Manual. 1058 */ 1059 1060#if defined(_AIX) || defined(AIX) || defined(sparc) || defined(__hppa) || defined(PPC) || defined(__powerpc__) && !defined(i386) && !defined(__i386) && !defined(__i386__) 1061 1062/* Big endian machines */ 1063# define _PATCHKEY(id) (0xfd00|id) 1064# define AFMT_S16_NE AFMT_S16_BE 1065# define AFMT_U16_NE AFMT_U16_BE 1066# define AFMT_S32_NE AFMT_S32_BE 1067# define AFMT_S24_NE AFMT_S24_BE 1068# define AFMT_S16_OE AFMT_S16_LE 1069# define AFMT_S32_OE AFMT_S32_LE 1070# define AFMT_S24_OE AFMT_S24_LE 1071#else 1072# define _PATCHKEY(id) ((id<<8)|0xfd) 1073# define AFMT_S16_NE AFMT_S16_LE 1074# define AFMT_U16_NE AFMT_U16_LE 1075# define AFMT_S32_NE AFMT_S32_LE 1076# define AFMT_S24_NE AFMT_S24_LE 1077# define AFMT_S16_OE AFMT_S16_BE 1078# define AFMT_S32_OE AFMT_S32_BE 1079# define AFMT_S24_OE AFMT_S24_BE 1080#endif 1081/* 1082 * Buffer status queries. 1083 */ 1084typedef struct audio_buf_info 1085{ 1086 int fragments; /* # of available fragments (partially usend ones not counted) */ 1087 int fragstotal; /* Total # of fragments allocated */ 1088 int fragsize; /* Size of a fragment in bytes */ 1089 int bytes; /* Available space in bytes (includes partially used fragments) */ 1090 /* Note! 'bytes' could be more than fragments*fragsize */ 1091} audio_buf_info; 1092 1093#define SNDCTL_DSP_GETOSPACE __SIOR ('P',12, audio_buf_info) 1094#define SNDCTL_DSP_GETISPACE __SIOR ('P',13, audio_buf_info) 1095#define SNDCTL_DSP_GETCAPS __SIOR ('P',15, int) 1096# define PCM_CAP_REVISION 0x000000ff /* Bits for revision level (0 to 255) */ 1097# define PCM_CAP_DUPLEX 0x00000100 /* Full duplex record/playback */ 1098# define PCM_CAP_REALTIME 0x00000200 /* Not in use */ 1099# define PCM_CAP_BATCH 0x00000400 /* Device has some kind of */ 1100 /* internal buffers which may */ 1101 /* cause some delays and */ 1102 /* decrease precision of timing */ 1103# define PCM_CAP_COPROC 0x00000800 /* Has a coprocessor */ 1104 /* Sometimes it's a DSP */ 1105 /* but usually not */ 1106# define PCM_CAP_TRIGGER 0x00001000 /* Supports SETTRIGGER */ 1107# define PCM_CAP_MMAP 0x00002000 /* Supports mmap() */ 1108# define PCM_CAP_MULTI 0x00004000 /* Supports multiple open */ 1109# define PCM_CAP_BIND 0x00008000 /* Supports binding to front/rear/center/lfe */ 1110# define PCM_CAP_INPUT 0x00010000 /* Supports recording */ 1111# define PCM_CAP_OUTPUT 0x00020000 /* Supports playback */ 1112# define PCM_CAP_VIRTUAL 0x00040000 /* Virtual device */ 1113/* 0x00040000 and 0x00080000 reserved for future use */ 1114 1115/* Analog/digital control capabilities */ 1116# define PCM_CAP_ANALOGOUT 0x00100000 1117# define PCM_CAP_ANALOGIN 0x00200000 1118# define PCM_CAP_DIGITALOUT 0x00400000 1119# define PCM_CAP_DIGITALIN 0x00800000 1120# define PCM_CAP_ADMASK 0x00f00000 1121/* 1122 * NOTE! (capabilities & PCM_CAP_ADMASK)==0 means just that the 1123 * digital/analog interface control features are not supported by the 1124 * device/driver. However the device still supports analog, digital or 1125 * both inputs/outputs (depending on the device). See the OSS Programmer's 1126 * Guide for full details. 1127 */ 1128# define PCM_CAP_SHADOW 0x01000000 /* "Shadow" device */ 1129 1130/* 1131 * Preferred channel usage. These bits can be used to 1132 * give recommendations to the application. Used by few drivers. 1133 * For example if ((caps & DSP_CH_MASK) == DSP_CH_MONO) means that 1134 * the device works best in mono mode. However it doesn't necessarily mean 1135 * that the device cannot be used in stereo. These bits should only be used 1136 * by special applications such as multi track hard disk recorders to find 1137 * out the initial setup. However the user should be able to override this 1138 * selection. 1139 * 1140 * To find out which modes are actually supported the application should 1141 * try to select them using SNDCTL_DSP_CHANNELS. 1142 */ 1143# define DSP_CH_MASK 0x06000000 /* Mask */ 1144# define DSP_CH_ANY 0x00000000 /* No preferred mode */ 1145# define DSP_CH_MONO 0x02000000 1146# define DSP_CH_STEREO 0x04000000 1147# define DSP_CH_MULTI 0x06000000 /* More than two channels */ 1148 1149# define PCM_CAP_HIDDEN 0x08000000 /* Hidden device */ 1150# define PCM_CAP_FREERATE 0x10000000 1151# define PCM_CAP_MODEM 0x20000000 /* Modem device */ 1152# define PCM_CAP_DEFAULT 0x40000000 /* "Default" device */ 1153 1154/* 1155 * The PCM_CAP_* capability names were known as DSP_CAP_* prior OSS 4.0 1156 * so it's necessary to define the older names too. 1157 */ 1158#define DSP_CAP_ADMASK PCM_CAP_ADMASK 1159#define DSP_CAP_ANALOGIN PCM_CAP_ANALOGIN 1160#define DSP_CAP_ANALOGOUT PCM_CAP_ANALOGOUT 1161#define DSP_CAP_BATCH PCM_CAP_BATCH 1162#define DSP_CAP_BIND PCM_CAP_BIND 1163#define DSP_CAP_COPROC PCM_CAP_COPROC 1164#define DSP_CAP_DEFAULT PCM_CAP_DEFAULT 1165#define DSP_CAP_DIGITALIN PCM_CAP_DIGITALIN 1166#define DSP_CAP_DIGITALOUT PCM_CAP_DIGITALOUT 1167#define DSP_CAP_DUPLEX PCM_CAP_DUPLEX 1168#define DSP_CAP_FREERATE PCM_CAP_FREERATE 1169#define DSP_CAP_HIDDEN PCM_CAP_HIDDEN 1170#define DSP_CAP_INPUT PCM_CAP_INPUT 1171#define DSP_CAP_MMAP PCM_CAP_MMAP 1172#define DSP_CAP_MODEM PCM_CAP_MODEM 1173#define DSP_CAP_MULTI PCM_CAP_MULTI 1174#define DSP_CAP_OUTPUT PCM_CAP_OUTPUT 1175#define DSP_CAP_REALTIME PCM_CAP_REALTIME 1176#define DSP_CAP_REVISION PCM_CAP_REVISION 1177#define DSP_CAP_SHADOW PCM_CAP_SHADOW 1178#define DSP_CAP_TRIGGER PCM_CAP_TRIGGER 1179#define DSP_CAP_VIRTUAL PCM_CAP_VIRTUAL 1180 1181#define SNDCTL_DSP_GETTRIGGER __SIOR ('P',16, int) 1182#define SNDCTL_DSP_SETTRIGGER __SIOW ('P',16, int) 1183# define PCM_ENABLE_INPUT 0x00000001 1184# define PCM_ENABLE_OUTPUT 0x00000002 1185 1186typedef struct count_info 1187{ 1188 unsigned int bytes; /* Total # of bytes processed */ 1189 int blocks; /* # of fragment transitions since last time */ 1190 int ptr; /* Current DMA pointer value */ 1191} count_info; 1192 1193#define SNDCTL_DSP_GETIPTR __SIOR ('P',17, count_info) 1194#define SNDCTL_DSP_GETOPTR __SIOR ('P',18, count_info) 1195 1196typedef struct buffmem_desc 1197{ 1198 unsigned *buffer; 1199 int size; 1200} buffmem_desc; 1201#define SNDCTL_DSP_SETSYNCRO __SIO ('P', 21) 1202#define SNDCTL_DSP_SETDUPLEX __SIO ('P', 22) 1203 1204#define SNDCTL_DSP_PROFILE __SIOW ('P', 23, int) /* OBSOLETE */ 1205#define APF_NORMAL 0 /* Normal applications */ 1206#define APF_NETWORK 1 /* Underruns probably caused by an "external" delay */ 1207#define APF_CPUINTENS 2 /* Underruns probably caused by "overheating" the CPU */ 1208 1209#define SNDCTL_DSP_GETODELAY __SIOR ('P', 23, int) 1210 1211typedef struct audio_errinfo 1212{ 1213 int play_underruns; 1214 int rec_overruns; 1215 unsigned int play_ptradjust; 1216 unsigned int rec_ptradjust; 1217 int play_errorcount; 1218 int rec_errorcount; 1219 int play_lasterror; 1220 int rec_lasterror; 1221 int play_errorparm; 1222 int rec_errorparm; 1223 int filler[16]; 1224} audio_errinfo; 1225 1226#define SNDCTL_DSP_GETPLAYVOL __SIOR ('P', 24, int) 1227#define SNDCTL_DSP_SETPLAYVOL __SIOWR('P', 24, int) 1228#define SNDCTL_DSP_GETERROR __SIOR ('P', 25, audio_errinfo) 1229/* 1230 **************************************************************************** 1231 * Digital interface (S/PDIF) control interface 1232 */ 1233 1234typedef struct oss_digital_control 1235{ 1236 unsigned int caps; 1237#define DIG_CBITIN_NONE 0x00000000 1238#define DIG_CBITIN_LIMITED 0x00000001 1239#define DIG_CBITIN_DATA 0x00000002 1240#define DIG_CBITIN_BYTE0 0x00000004 1241#define DIG_CBITIN_FULL 0x00000008 1242#define DIG_CBITIN_MASK 0x0000000f 1243#define DIG_CBITOUT_NONE 0x00000000 1244#define DIG_CBITOUT_LIMITED 0x00000010 1245#define DIG_CBITOUT_BYTE0 0x00000020 1246#define DIG_CBITOUT_FULL 0x00000040 1247#define DIG_CBITOUT_DATA 0x00000080 1248#define DIG_CBITOUT_MASK 0x000000f0 1249#define DIG_UBITIN 0x00000100 1250#define DIG_UBITOUT 0x00000200 1251#define DIG_VBITOUT 0x00000400 1252#define DIG_OUTRATE 0x00000800 1253#define DIG_INRATE 0x00001000 1254#define DIG_INBITS 0x00002000 1255#define DIG_OUTBITS 0x00004000 1256#define DIG_EXACT 0x00010000 1257#define DIG_PRO 0x00020000 1258#define DIG_CONSUMER 0x00040000 1259#define DIG_PASSTHROUGH 0x00080000 1260#define DIG_OUTSEL 0x00100000 1261 1262 unsigned int valid; 1263#define VAL_CBITIN 0x00000001 1264#define VAL_UBITIN 0x00000002 1265#define VAL_CBITOUT 0x00000004 1266#define VAL_UBITOUT 0x00000008 1267#define VAL_ISTATUS 0x00000010 1268#define VAL_IRATE 0x00000020 1269#define VAL_ORATE 0x00000040 1270#define VAL_INBITS 0x00000080 1271#define VAL_OUTBITS 0x00000100 1272#define VAL_REQUEST 0x00000200 1273#define VAL_OUTSEL 0x00000400 1274 1275#define VAL_OUTMASK (VAL_CBITOUT|VAL_UBITOUT|VAL_ORATE|VAL_OUTBITS|VAL_OUTSEL) 1276 1277 unsigned int request, param; 1278#define SPD_RQ_PASSTHROUGH 1 1279 1280 unsigned char cbitin[24]; 1281 unsigned char ubitin[24]; 1282 unsigned char cbitout[24]; 1283 unsigned char ubitout[24]; 1284 1285 unsigned int outsel; 1286#define OUTSEL_DIGITAL 1 1287#define OUTSEL_ANALOG 2 1288#define OUTSEL_BOTH (OUTSEL_DIGITAL|OUTSEL_ANALOG) 1289 1290 int in_data; /* Audio/data if autodetectable by the receiver */ 1291#define IND_UNKNOWN 0 1292#define IND_AUDIO 1 1293#define IND_DATA 2 1294 1295 int in_locked; /* Receiver locked */ 1296#define LOCK_NOT_INDICATED 0 1297#define LOCK_UNLOCKED 1 1298#define LOCK_LOCKED 2 1299 1300 int in_quality; /* Input signal quality */ 1301#define IN_QUAL_NOT_INDICATED 0 1302#define IN_QUAL_POOR 1 1303#define IN_QUAL_GOOD 2 1304 1305 int in_vbit, out_vbit; /* V bits */ 1306#define VBIT_NOT_INDICATED 0 1307#define VBIT_OFF 1 1308#define VBIT_ON 2 1309 1310 unsigned int in_errors; /* Various input error conditions */ 1311#define INERR_CRC 0x0001 1312#define INERR_QCODE_CRC 0x0002 1313#define INERR_PARITY 0x0004 1314#define INERR_BIPHASE 0x0008 1315 1316 int srate_in, srate_out; 1317 int bits_in, bits_out; 1318 1319 int filler[32]; 1320} oss_digital_control; 1321 1322#define SNDCTL_DSP_READCTL __SIOWR('P', 26, oss_digital_control) 1323#define SNDCTL_DSP_WRITECTL __SIOWR('P', 27, oss_digital_control) 1324 1325/* 1326 **************************************************************************** 1327 * Sync groups for audio devices 1328 */ 1329typedef struct oss_syncgroup 1330{ 1331 int id; 1332 int mode; 1333 int filler[16]; 1334} oss_syncgroup; 1335 1336#define SNDCTL_DSP_SYNCGROUP __SIOWR('P', 28, oss_syncgroup) 1337#define SNDCTL_DSP_SYNCSTART __SIOW ('P', 29, int) 1338 1339/* 1340 ************************************************************************** 1341 * "cooked" mode enables software based conversions for sample rate, sample 1342 * format (bits) and number of channels (mono/stereo). These conversions are 1343 * required with some devices that support only one sample rate or just stereo 1344 * to let the applications to use other formats. The cooked mode is enabled by 1345 * default. However it's necessary to disable this mode when mmap() is used or 1346 * when very deterministic timing is required. SNDCTL_DSP_COOKEDMODE is an 1347 * optional call introduced in OSS 3.9.6f. It's _error return must be ignored_ 1348 * since normally this call will return erno=EINVAL. 1349 * 1350 * SNDCTL_DSP_COOKEDMODE must be called immediately after open before doing 1351 * anything else. Otherwise the call will not have any effect. 1352 */ 1353#define SNDCTL_DSP_COOKEDMODE __SIOW ('P', 30, int) 1354 1355/* 1356 ************************************************************************** 1357 * SNDCTL_DSP_SILENCE and SNDCTL_DSP_SKIP are new calls in OSS 3.99.0 1358 * that can be used to implement pause/continue during playback (no effect 1359 * on recording). 1360 */ 1361#define SNDCTL_DSP_SILENCE __SIO ('P', 31) 1362#define SNDCTL_DSP_SKIP __SIO ('P', 32) 1363/* 1364 **************************************************************************** 1365 * Abort transfer (reset) functions for input and output 1366 */ 1367#define SNDCTL_DSP_HALT_INPUT __SIO ('P', 33) 1368#define SNDCTL_DSP_RESET_INPUT SNDCTL_DSP_HALT_INPUT /* Old name */ 1369#define SNDCTL_DSP_HALT_OUTPUT __SIO ('P', 34) 1370#define SNDCTL_DSP_RESET_OUTPUT SNDCTL_DSP_HALT_OUTPUT /* Old name */ 1371/* 1372 **************************************************************************** 1373 * Low water level control 1374 */ 1375#define SNDCTL_DSP_LOW_WATER __SIOW ('P', 34, int) 1376 1377/* 1378 **************************************************************************** 1379 * 64 bit pointer support. Only available in environments that support 1380 * the 64 bit (long long) integer type. 1381 */ 1382#ifndef OSS_NO_LONG_LONG 1383typedef struct 1384{ 1385 long long samples; 1386 int fifo_samples; 1387 int filler[32]; /* For future use */ 1388} oss_count_t; 1389 1390#define SNDCTL_DSP_CURRENT_IPTR __SIOR ('P', 35, oss_count_t) 1391#define SNDCTL_DSP_CURRENT_OPTR __SIOR ('P', 36, oss_count_t) 1392#endif 1393 1394/* 1395 **************************************************************************** 1396 * Interface for selecting recording sources and playback output routings. 1397 */ 1398#define SNDCTL_DSP_GET_RECSRC_NAMES __SIOR ('P', 37, oss_mixer_enuminfo) 1399#define SNDCTL_DSP_GET_RECSRC __SIOR ('P', 38, int) 1400#define SNDCTL_DSP_SET_RECSRC __SIOWR('P', 38, int) 1401 1402#define SNDCTL_DSP_GET_PLAYTGT_NAMES __SIOR ('P', 39, oss_mixer_enuminfo) 1403#define SNDCTL_DSP_GET_PLAYTGT __SIOR ('P', 40, int) 1404#define SNDCTL_DSP_SET_PLAYTGT __SIOWR('P', 40, int) 1405#define SNDCTL_DSP_GETRECVOL __SIOR ('P', 41, int) 1406#define SNDCTL_DSP_SETRECVOL __SIOWR('P', 41, int) 1407 1408/* 1409 *************************************************************************** 1410 * Some calls for setting the channel assignment with multi channel devices 1411 * (see the manual for details). 1412 */ 1413#ifndef OSS_NO_LONG_LONG 1414#define SNDCTL_DSP_GET_CHNORDER __SIOR ('P', 42, unsigned long long) 1415#define SNDCTL_DSP_SET_CHNORDER __SIOWR('P', 42, unsigned long long) 1416# define CHID_UNDEF 0 1417# define CHID_L 1 1418# define CHID_R 2 1419# define CHID_C 3 1420# define CHID_LFE 4 1421# define CHID_LS 5 1422# define CHID_RS 6 1423# define CHID_LR 7 1424# define CHID_RR 8 1425#define CHNORDER_UNDEF 0x0000000000000000ULL 1426#define CHNORDER_NORMAL 0x0000000087654321ULL 1427#endif 1428 1429#define MAX_PEAK_CHANNELS 128 1430typedef unsigned short oss_peaks_t[MAX_PEAK_CHANNELS]; 1431#define SNDCTL_DSP_GETIPEAKS __SIOR('P', 43, oss_peaks_t) 1432#define SNDCTL_DSP_GETOPEAKS __SIOR('P', 44, oss_peaks_t) 1433 1434#define SNDCTL_DSP_POLICY __SIOW('P', 45, int) /* See the manual */ 1435 1436/* 1437 **************************************************************************** 1438 * Few ioctl calls that are not official parts of OSS. They have been used 1439 * by few freeware implementations of OSS. 1440 */ 1441#define SNDCTL_DSP_GETCHANNELMASK __SIOWR('P', 64, int) 1442#define SNDCTL_DSP_BIND_CHANNEL __SIOWR('P', 65, int) 1443# define DSP_BIND_QUERY 0x00000000 1444# define DSP_BIND_FRONT 0x00000001 1445# define DSP_BIND_SURR 0x00000002 1446# define DSP_BIND_CENTER_LFE 0x00000004 1447# define DSP_BIND_HANDSET 0x00000008 1448# define DSP_BIND_MIC 0x00000010 1449# define DSP_BIND_MODEM1 0x00000020 1450# define DSP_BIND_MODEM2 0x00000040 1451# define DSP_BIND_I2S 0x00000080 1452# define DSP_BIND_SPDIF 0x00000100 1453# define DSP_BIND_REAR 0x00000200 1454 1455#ifndef NO_LEGACY_MIXER 1456/* 1457 **************************************************************************** 1458 * IOCTL commands for the "legacy " /dev/mixer API (obsolete) 1459 * 1460 * Mixer controls 1461 * 1462 * There can be up to 20 different analog mixer channels. The 1463 * SOUND_MIXER_NRDEVICES gives the currently supported maximum. 1464 * The SOUND_MIXER_READ_DEVMASK returns a bitmask which tells 1465 * the devices supported by the particular mixer. 1466 * 1467 * {!notice This "legacy" mixer API is obsolete. It has been superceded 1468 * by a new one (see below). 1469 */ 1470 1471#define SOUND_MIXER_NRDEVICES 28 1472#define SOUND_MIXER_VOLUME 0 1473#define SOUND_MIXER_BASS 1 1474#define SOUND_MIXER_TREBLE 2 1475#define SOUND_MIXER_SYNTH 3 1476#define SOUND_MIXER_PCM 4 1477#define SOUND_MIXER_SPEAKER 5 1478#define SOUND_MIXER_LINE 6 1479#define SOUND_MIXER_MIC 7 1480#define SOUND_MIXER_CD 8 1481#define SOUND_MIXER_IMIX 9 /* Recording monitor */ 1482#define SOUND_MIXER_ALTPCM 10 1483#define SOUND_MIXER_RECLEV 11 /* Recording level */ 1484#define SOUND_MIXER_IGAIN 12 /* Input gain */ 1485#define SOUND_MIXER_OGAIN 13 /* Output gain */ 1486/* 1487 * Some soundcards have three line level inputs (line, aux1 and aux2). 1488 * Since each card manufacturer has assigned different meanings to 1489 * these inputs, it's impractical to assign specific meanings 1490 * (eg line, cd, synth etc.) to them. 1491 */ 1492#define SOUND_MIXER_LINE1 14 /* Input source 1 (aux1) */ 1493#define SOUND_MIXER_LINE2 15 /* Input source 2 (aux2) */ 1494#define SOUND_MIXER_LINE3 16 /* Input source 3 (line) */ 1495#define SOUND_MIXER_DIGITAL1 17 /* Digital I/O 1 */ 1496#define SOUND_MIXER_DIGITAL2 18 /* Digital I/O 2 */ 1497#define SOUND_MIXER_DIGITAL3 19 /* Digital I/O 3 */ 1498#define SOUND_MIXER_PHONE 20 /* Phone */ 1499#define SOUND_MIXER_MONO 21 /* Mono Output */ 1500#define SOUND_MIXER_VIDEO 22 /* Video/TV (audio) in */ 1501#define SOUND_MIXER_RADIO 23 /* Radio in */ 1502#define SOUND_MIXER_DEPTH 24 /* Surround depth */ 1503#define SOUND_MIXER_REARVOL 25 /* Rear/Surround speaker vol */ 1504#define SOUND_MIXER_CENTERVOL 26 /* Center/LFE speaker vol */ 1505#define SOUND_MIXER_SIDEVOL 27 /* Side-Surround (8speaker) vol */ 1506 1507/* 1508 * Warning: SOUND_MIXER_SURRVOL is an old name of SOUND_MIXER_SIDEVOL. 1509 * They are both assigned to the same mixer control. Don't 1510 * use both control names in the same program/driver. 1511 */ 1512#define SOUND_MIXER_SURRVOL SOUND_MIXER_SIDEVOL 1513 1514/* Some on/off settings (SOUND_SPECIAL_MIN - SOUND_SPECIAL_MAX) */ 1515/* Not counted to SOUND_MIXER_NRDEVICES, but use the same number space */ 1516#define SOUND_ONOFF_MIN 28 1517#define SOUND_ONOFF_MAX 30 1518 1519/* Note! Number 31 cannot be used since the sign bit is reserved */ 1520#define SOUND_MIXER_NONE 31 1521 1522/* 1523 * The following unsupported macros are no longer functional. 1524 * Use SOUND_MIXER_PRIVATE# macros in future. 1525 */ 1526#define SOUND_MIXER_ENHANCE SOUND_MIXER_NONE 1527#define SOUND_MIXER_MUTE SOUND_MIXER_NONE 1528#define SOUND_MIXER_LOUD SOUND_MIXER_NONE 1529 1530#define SOUND_DEVICE_LABELS \ 1531 {"Vol ", "Bass ", "Treble", "Synth", "Pcm ", "Speaker ", "Line ", \ 1532 "Mic ", "CD ", "Mix ", "Pcm2 ", "Rec ", "IGain", "OGain", \ 1533 "Aux1", "Aux2", "Aux3", "Digital1", "Digital2", "Digital3", \ 1534 "Phone", "Mono", "Video", "Radio", "Depth", \ 1535 "Rear", "Center", "Side"} 1536 1537#define SOUND_DEVICE_NAMES \ 1538 {"vol", "bass", "treble", "synth", "pcm", "speaker", "line", \ 1539 "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain", \ 1540 "aux1", "aux2", "aux3", "dig1", "dig2", "dig3", \ 1541 "phone", "mono", "video", "radio", "depth", \ 1542 "rear", "center", "side"} 1543 1544/* Device bitmask identifiers */ 1545 1546#define SOUND_MIXER_RECSRC 0xff /* Arg contains a bit for each recording source */ 1547#define SOUND_MIXER_DEVMASK 0xfe /* Arg contains a bit for each supported device */ 1548#define SOUND_MIXER_RECMASK 0xfd /* Arg contains a bit for each supported recording source */ 1549#define SOUND_MIXER_CAPS 0xfc 1550# define SOUND_CAP_EXCL_INPUT 0x00000001 /* Only one recording source at a time */ 1551# define SOUND_CAP_NOLEGACY 0x00000004 /* For internal use only */ 1552# define SOUND_CAP_NORECSRC 0x00000008 1553#define SOUND_MIXER_STEREODEVS 0xfb /* Mixer channels supporting stereo */ 1554 1555/* OSS/Free ONLY */ 1556#define SOUND_MIXER_OUTSRC 0xfa /* Arg contains a bit for each input source to output */ 1557#define SOUND_MIXER_OUTMASK 0xf9 /* Arg contains a bit for each supported input source to output */ 1558/* OSS/Free ONLY */ 1559 1560/* Device mask bits */ 1561 1562#define SOUND_MASK_VOLUME (1 << SOUND_MIXER_VOLUME) 1563#define SOUND_MASK_BASS (1 << SOUND_MIXER_BASS) 1564#define SOUND_MASK_TREBLE (1 << SOUND_MIXER_TREBLE) 1565#define SOUND_MASK_SYNTH (1 << SOUND_MIXER_SYNTH) 1566#define SOUND_MASK_PCM (1 << SOUND_MIXER_PCM) 1567#define SOUND_MASK_SPEAKER (1 << SOUND_MIXER_SPEAKER) 1568#define SOUND_MASK_LINE (1 << SOUND_MIXER_LINE) 1569#define SOUND_MASK_MIC (1 << SOUND_MIXER_MIC) 1570#define SOUND_MASK_CD (1 << SOUND_MIXER_CD) 1571#define SOUND_MASK_IMIX (1 << SOUND_MIXER_IMIX) 1572#define SOUND_MASK_ALTPCM (1 << SOUND_MIXER_ALTPCM) 1573#define SOUND_MASK_RECLEV (1 << SOUND_MIXER_RECLEV) 1574#define SOUND_MASK_IGAIN (1 << SOUND_MIXER_IGAIN) 1575#define SOUND_MASK_OGAIN (1 << SOUND_MIXER_OGAIN) 1576#define SOUND_MASK_LINE1 (1 << SOUND_MIXER_LINE1) 1577#define SOUND_MASK_LINE2 (1 << SOUND_MIXER_LINE2) 1578#define SOUND_MASK_LINE3 (1 << SOUND_MIXER_LINE3) 1579#define SOUND_MASK_DIGITAL1 (1 << SOUND_MIXER_DIGITAL1) 1580#define SOUND_MASK_DIGITAL2 (1 << SOUND_MIXER_DIGITAL2) 1581#define SOUND_MASK_DIGITAL3 (1 << SOUND_MIXER_DIGITAL3) 1582#define SOUND_MASK_MONO (1 << SOUND_MIXER_MONO) 1583#define SOUND_MASK_PHONE (1 << SOUND_MIXER_PHONE) 1584#define SOUND_MASK_RADIO (1 << SOUND_MIXER_RADIO) 1585#define SOUND_MASK_VIDEO (1 << SOUND_MIXER_VIDEO) 1586#define SOUND_MASK_DEPTH (1 << SOUND_MIXER_DEPTH) 1587#define SOUND_MASK_REARVOL (1 << SOUND_MIXER_REARVOL) 1588#define SOUND_MASK_CENTERVOL (1 << SOUND_MIXER_CENTERVOL) 1589#define SOUND_MASK_SIDEVOL (1 << SOUND_MIXER_SIDEVOL) 1590 1591/* Note! SOUND_MASK_SURRVOL is alias of SOUND_MASK_SIDEVOL */ 1592#define SOUND_MASK_SURRVOL (1 << SOUND_MIXER_SIDEVOL) 1593 1594/* Obsolete macros */ 1595#define SOUND_MASK_MUTE (1 << SOUND_MIXER_MUTE) 1596#define SOUND_MASK_ENHANCE (1 << SOUND_MIXER_ENHANCE) 1597#define SOUND_MASK_LOUD (1 << SOUND_MIXER_LOUD) 1598 1599#define MIXER_READ(dev) __SIOR('M', dev, int) 1600#define SOUND_MIXER_READ_VOLUME MIXER_READ(SOUND_MIXER_VOLUME) 1601#define SOUND_MIXER_READ_BASS MIXER_READ(SOUND_MIXER_BASS) 1602#define SOUND_MIXER_READ_TREBLE MIXER_READ(SOUND_MIXER_TREBLE) 1603#define SOUND_MIXER_READ_SYNTH MIXER_READ(SOUND_MIXER_SYNTH) 1604#define SOUND_MIXER_READ_PCM MIXER_READ(SOUND_MIXER_PCM) 1605#define SOUND_MIXER_READ_SPEAKER MIXER_READ(SOUND_MIXER_SPEAKER) 1606#define SOUND_MIXER_READ_LINE MIXER_READ(SOUND_MIXER_LINE) 1607#define SOUND_MIXER_READ_MIC MIXER_READ(SOUND_MIXER_MIC) 1608#define SOUND_MIXER_READ_CD MIXER_READ(SOUND_MIXER_CD) 1609#define SOUND_MIXER_READ_IMIX MIXER_READ(SOUND_MIXER_IMIX) 1610#define SOUND_MIXER_READ_ALTPCM MIXER_READ(SOUND_MIXER_ALTPCM) 1611#define SOUND_MIXER_READ_RECLEV MIXER_READ(SOUND_MIXER_RECLEV) 1612#define SOUND_MIXER_READ_IGAIN MIXER_READ(SOUND_MIXER_IGAIN) 1613#define SOUND_MIXER_READ_OGAIN MIXER_READ(SOUND_MIXER_OGAIN) 1614#define SOUND_MIXER_READ_LINE1 MIXER_READ(SOUND_MIXER_LINE1) 1615#define SOUND_MIXER_READ_LINE2 MIXER_READ(SOUND_MIXER_LINE2) 1616#define SOUND_MIXER_READ_LINE3 MIXER_READ(SOUND_MIXER_LINE3) 1617 1618/* Obsolete macros */ 1619#define SOUND_MIXER_READ_MUTE MIXER_READ(SOUND_MIXER_MUTE) 1620#define SOUND_MIXER_READ_ENHANCE MIXER_READ(SOUND_MIXER_ENHANCE) 1621#define SOUND_MIXER_READ_LOUD MIXER_READ(SOUND_MIXER_LOUD) 1622 1623#define SOUND_MIXER_READ_RECSRC MIXER_READ(SOUND_MIXER_RECSRC) 1624#define SOUND_MIXER_READ_DEVMASK MIXER_READ(SOUND_MIXER_DEVMASK) 1625#define SOUND_MIXER_READ_RECMASK MIXER_READ(SOUND_MIXER_RECMASK) 1626#define SOUND_MIXER_READ_STEREODEVS MIXER_READ(SOUND_MIXER_STEREODEVS) 1627#define SOUND_MIXER_READ_CAPS MIXER_READ(SOUND_MIXER_CAPS) 1628 1629#define MIXER_WRITE(dev) __SIOWR('M', dev, int) 1630#define SOUND_MIXER_WRITE_VOLUME MIXER_WRITE(SOUND_MIXER_VOLUME) 1631#define SOUND_MIXER_WRITE_BASS MIXER_WRITE(SOUND_MIXER_BASS) 1632#define SOUND_MIXER_WRITE_TREBLE MIXER_WRITE(SOUND_MIXER_TREBLE) 1633#define SOUND_MIXER_WRITE_SYNTH MIXER_WRITE(SOUND_MIXER_SYNTH) 1634#define SOUND_MIXER_WRITE_PCM MIXER_WRITE(SOUND_MIXER_PCM) 1635#define SOUND_MIXER_WRITE_SPEAKER MIXER_WRITE(SOUND_MIXER_SPEAKER) 1636#define SOUND_MIXER_WRITE_LINE MIXER_WRITE(SOUND_MIXER_LINE) 1637#define SOUND_MIXER_WRITE_MIC MIXER_WRITE(SOUND_MIXER_MIC) 1638#define SOUND_MIXER_WRITE_CD MIXER_WRITE(SOUND_MIXER_CD) 1639#define SOUND_MIXER_WRITE_IMIX MIXER_WRITE(SOUND_MIXER_IMIX) 1640#define SOUND_MIXER_WRITE_ALTPCM MIXER_WRITE(SOUND_MIXER_ALTPCM) 1641#define SOUND_MIXER_WRITE_RECLEV MIXER_WRITE(SOUND_MIXER_RECLEV) 1642#define SOUND_MIXER_WRITE_IGAIN MIXER_WRITE(SOUND_MIXER_IGAIN) 1643#define SOUND_MIXER_WRITE_OGAIN MIXER_WRITE(SOUND_MIXER_OGAIN) 1644#define SOUND_MIXER_WRITE_LINE1 MIXER_WRITE(SOUND_MIXER_LINE1) 1645#define SOUND_MIXER_WRITE_LINE2 MIXER_WRITE(SOUND_MIXER_LINE2) 1646#define SOUND_MIXER_WRITE_LINE3 MIXER_WRITE(SOUND_MIXER_LINE3) 1647 1648/* Obsolete macros */ 1649#define SOUND_MIXER_WRITE_MUTE MIXER_WRITE(SOUND_MIXER_MUTE) 1650#define SOUND_MIXER_WRITE_ENHANCE MIXER_WRITE(SOUND_MIXER_ENHANCE) 1651#define SOUND_MIXER_WRITE_LOUD MIXER_WRITE(SOUND_MIXER_LOUD) 1652 1653#define SOUND_MIXER_WRITE_RECSRC MIXER_WRITE(SOUND_MIXER_RECSRC) 1654 1655typedef struct mixer_info /* OBSOLETE */ 1656{ 1657 char id[16]; 1658 char name[32]; 1659 int modify_counter; 1660 int card_number; 1661 int port_number; 1662 char handle[32]; 1663} mixer_info; 1664 1665/* SOUND_MIXER_INFO is obsolete - use SNDCTL_MIXERINFO instead */ 1666#define SOUND_MIXER_INFO __SIOR ('M', 101, mixer_info) 1667 1668/* 1669 * Two ioctls for special souncard function (OSS/Free only) 1670 */ 1671#define SOUND_MIXER_AGC _SIOWR('M', 103, int) 1672#define SOUND_MIXER_3DSE _SIOWR('M', 104, int) 1673/* 1674 * The SOUND_MIXER_PRIVATE# commands can be redefined by low level drivers. 1675 * These features can be used when accessing device specific features. 1676 */ 1677#define SOUND_MIXER_PRIVATE1 __SIOWR('M', 111, int) 1678#define SOUND_MIXER_PRIVATE2 __SIOWR('M', 112, int) 1679#define SOUND_MIXER_PRIVATE3 __SIOWR('M', 113, int) 1680#define SOUND_MIXER_PRIVATE4 __SIOWR('M', 114, int) 1681#define SOUND_MIXER_PRIVATE5 __SIOWR('M', 115, int) 1682 1683/* The following two controls were never implemented and they should not be used. */ 1684#define SOUND_MIXER_READ_MAINVOL __SIOR ('M', 116, int) 1685#define SOUND_MIXER_WRITE_MAINVOL __SIOWR('M', 116, int) 1686 1687/* 1688 * SOUND_MIXER_GETLEVELS and SOUND_MIXER_SETLEVELS calls can be used 1689 * for querying current mixer settings from the driver and for loading 1690 * default volume settings _prior_ activating the mixer (loading 1691 * doesn't affect current state of the mixer hardware). These calls 1692 * are for internal use by the driver software only. 1693 */ 1694 1695typedef struct mixer_vol_table 1696{ 1697 int num; /* Index to volume table */ 1698 char name[32]; 1699 int levels[32]; 1700} mixer_vol_table; 1701 1702#define SOUND_MIXER_GETLEVELS __SIOWR('M', 116, mixer_vol_table) 1703#define SOUND_MIXER_SETLEVELS __SIOWR('M', 117, mixer_vol_table) 1704 1705#define OSS_GETVERSION __SIOR ('M', 118, int) 1706 1707/* 1708 * Calls to set/get the recording gain for the currently active 1709 * recording source. These calls automatically map to the right control. 1710 * Note that these calls are not supported by all drivers. In this case 1711 * the call will return -1 with errno set to EINVAL 1712 * 1713 * The _MONGAIN work in similar way but set/get the monitoring gain for 1714 * the currently selected recording source. 1715 */ 1716#define SOUND_MIXER_READ_RECGAIN __SIOR ('M', 119, int) 1717#define SOUND_MIXER_WRITE_RECGAIN __SIOWR('M', 119, int) 1718#define SOUND_MIXER_READ_MONGAIN __SIOR ('M', 120, int) 1719#define SOUND_MIXER_WRITE_MONGAIN __SIOWR('M', 120, int) 1720 1721/* The following call is for driver development time purposes. It's not 1722 * present in any released drivers. 1723 */ 1724typedef unsigned char oss_reserved_t[512]; 1725#define SOUND_MIXER_RESERVED __SIOWR('M', 121, oss_reserved_t) 1726#endif /* ifndef NO_LEGACY_MIXER */ 1727 1728/* 1729 ************************************************************************* 1730 * The "new" mixer API of OSS 4.0 and later. 1731 * 1732 * This improved mixer API makes it possible to access every possible feature 1733 * of every possible device. However you should read the mixer programming 1734 * section of the OSS API Developer's Manual. There is no chance that you 1735 * could use this interface correctly just by examining this header. 1736 */ 1737 1738typedef struct oss_sysinfo 1739{ 1740 char product[32]; /* For example OSS/Free, OSS/Linux or OSS/Solaris */ 1741 char version[32]; /* For example 4.0a */ 1742 int versionnum; /* See OSS_GETVERSION */ 1743 char options[128]; /* Reserved */ 1744 1745 int numaudios; /* # of audio/dsp devices */ 1746 int openedaudio[8]; /* Bit mask telling which audio devices are busy */ 1747 1748 int numsynths; /* # of availavle synth devices */ 1749 int nummidis; /* # of available MIDI ports */ 1750 int numtimers; /* # of available timer devices */ 1751 int nummixers; /* # of mixer devices */ 1752 1753 int openedmidi[8]; /* Bit mask telling which midi devices are busy */ 1754 int numcards; /* Number of sound cards in the system */ 1755 int numaudioengines; /* Number of audio engines in the system */ 1756 char license[16]; /* For example "GPL" or "CDDL" */ 1757 int filler[236]; /* For future expansion (set to -1) */ 1758} oss_sysinfo; 1759 1760typedef struct oss_mixext 1761{ 1762 int dev; /* Mixer device number */ 1763 int ctrl; /* Controller number */ 1764 int type; /* Entry type */ 1765# define MIXT_DEVROOT 0 /* Device root entry */ 1766# define MIXT_GROUP 1 /* Controller group */ 1767# define MIXT_ONOFF 2 /* OFF (0) or ON (1) */ 1768# define MIXT_ENUM 3 /* Enumerated (0 to maxvalue) */ 1769# define MIXT_MONOSLIDER 4 /* Mono slider (0 to 255) */ 1770# define MIXT_STEREOSLIDER 5 /* Stereo slider (dual 0 to 255) */ 1771# define MIXT_MESSAGE 6 /* (Readable) textual message */ 1772# define MIXT_MONOVU 7 /* VU meter value (mono) */ 1773# define MIXT_STEREOVU 8 /* VU meter value (stereo) */ 1774# define MIXT_MONOPEAK 9 /* VU meter peak value (mono) */ 1775# define MIXT_STEREOPEAK 10 /* VU meter peak value (stereo) */ 1776# define MIXT_RADIOGROUP 11 /* Radio button group */ 1777# define MIXT_MARKER 12 /* Separator between normal and extension entries */ 1778# define MIXT_VALUE 13 /* Decimal value entry */ 1779# define MIXT_HEXVALUE 14 /* Hexadecimal value entry */ 1780# define MIXT_MONODB 15 /* OBSOLETE */ 1781# define MIXT_STEREODB 16 /* OBSOLETE */ 1782# define MIXT_SLIDER 17 /* Slider (mono) with full (31 bit) postitive integer range */ 1783# define MIXT_3D 18 1784 1785/* 1786 * Sliders with range expanded to 15 bits per channel (0-32767) 1787 */ 1788# define MIXT_MONOSLIDER16 19 1789# define MIXT_STEREOSLIDER16 20 1790 1791 /* Possible value range (minvalue to maxvalue) */ 1792 /* Note that maxvalue may also be smaller than minvalue */ 1793 int maxvalue; 1794 int minvalue; 1795 1796 int flags; 1797# define MIXF_READABLE 0x00000001 /* Has readable value */ 1798# define MIXF_WRITEABLE 0x00000002 /* Has writeable value */ 1799# define MIXF_POLL 0x00000004 /* May change itself */ 1800# define MIXF_HZ 0x00000008 /* Herz scale */ 1801# define MIXF_STRING 0x00000010 /* Use dynamic extensions for value */ 1802# define MIXF_DYNAMIC 0x00000010 /* Supports dynamic extensions */ 1803# define MIXF_OKFAIL 0x00000020 /* Interpret value as 1=OK, 0=FAIL */ 1804# define MIXF_FLAT 0x00000040 /* Flat vertical space requirements */ 1805# define MIXF_LEGACY 0x00000080 /* Legacy mixer control group */ 1806# define MIXF_CENTIBEL 0x00000100 /* Centibel (0.1 dB) step size */ 1807# define MIXF_DECIBEL 0x00000200 /* Step size of 1 dB */ 1808# define MIXF_MAINVOL 0x00000400 /* Main volume control */ 1809# define MIXF_PCMVOL 0x00000800 /* PCM output volume control */ 1810# define MIXF_RECVOL 0x00001000 /* PCM recording volume control */ 1811 char id[16]; /* Mnemonic ID (mainly for internal use) */ 1812 int parent; /* Entry# of parent (group) node (-1 if root) */ 1813 1814 int dummy; /* Internal use */ 1815 1816 int timestamp; 1817 1818 char data[64]; /* Misc data (entry type dependent) */ 1819 unsigned char enum_present[32]; /* Mask of allowed enum values */ 1820 int control_no; /* SOUND_MIXER_VOLUME..SOUND_MIXER_MIDI */ 1821 /* (-1 means not indicated) */ 1822 1823/* 1824 * The desc field is reserved for internal purposes of OSS. It should not be 1825 * used by applications. 1826 */ 1827 unsigned int desc; 1828#define MIXEXT_SCOPE_MASK 0x0000003f 1829#define MIXEXT_SCOPE_OTHER 0x00000000 1830#define MIXEXT_SCOPE_INPUT 0x00000001 1831#define MIXEXT_SCOPE_OUTPUT 0x00000002 1832#define MIXEXT_SCOPE_MONITOR 0x00000003 1833#define MIXEXT_SCOPE_RECSWITCH 0x00000004 1834 1835 char extname[32]; 1836 int update_counter; 1837 int filler[7]; 1838} oss_mixext; 1839 1840typedef struct oss_mixext_root 1841{ 1842 char id[16]; 1843 char name[48]; 1844} oss_mixext_root; 1845 1846typedef struct oss_mixer_value 1847{ 1848 int dev; 1849 int ctrl; 1850 int value; 1851 int flags; /* Reserved for future use. Initialize to 0 */ 1852 int timestamp; /* Must be set to oss_mixext.timestamp */ 1853 int filler[8]; /* Reserved for future use. Initialize to 0 */ 1854} oss_mixer_value; 1855 1856#define OSS_ENUM_MAXVALUE 255 1857typedef struct oss_mixer_enuminfo 1858{ 1859 int dev; 1860 int ctrl; 1861 int nvalues; 1862 int version; /* Read the manual */ 1863 short strindex[OSS_ENUM_MAXVALUE]; 1864 char strings[3000]; 1865} oss_mixer_enuminfo; 1866 1867#define OPEN_READ PCM_ENABLE_INPUT 1868#define OPEN_WRITE PCM_ENABLE_OUTPUT 1869#define OPEN_READWRITE (OPEN_READ|OPEN_WRITE) 1870 1871typedef struct oss_audioinfo 1872{ 1873 int dev; /* Audio device number */ 1874 char name[64]; 1875 int busy; /* 0, OPEN_READ, OPEN_WRITE or OPEN_READWRITE */ 1876 int pid; 1877 int caps; /* PCM_CAP_INPUT, PCM_CAP_OUTPUT */ 1878 int iformats, oformats; 1879 int magic; /* Reserved for internal use */ 1880 char cmd[64]; /* Command using the device (if known) */ 1881 int card_number; 1882 int port_number; 1883 int mixer_dev; 1884 int legacy_device; /* Obsolete field. Replaced by devnode */ 1885 int enabled; /* 1=enabled, 0=device not ready at this moment */ 1886 int flags; /* For internal use only - no practical meaning */ 1887 int min_rate, max_rate; /* Sample rate limits */ 1888 int min_channels, max_channels; /* Number of channels supported */ 1889 int binding; /* DSP_BIND_FRONT, etc. 0 means undefined */ 1890 int rate_source; 1891 char handle[32]; 1892#define OSS_MAX_SAMPLE_RATES 20 /* Cannot be changed */ 1893 unsigned int nrates, rates[OSS_MAX_SAMPLE_RATES]; /* Please read the manual before using these */ 1894 oss_longname_t song_name; /* Song name (if given) */ 1895 oss_label_t label; /* Device label (if given) */ 1896 int latency; /* In usecs, -1=unknown */ 1897 oss_devnode_t devnode; /* Device special file name (absolute path) */ 1898 int next_play_engine; /* Read the documentation for more info */ 1899 int next_rec_engine; /* Read the documentation for more info */ 1900 int filler[184]; 1901} oss_audioinfo; 1902 1903typedef struct oss_mixerinfo 1904{ 1905 int dev; 1906 char id[16]; 1907 char name[32]; 1908 int modify_counter; 1909 int card_number; 1910 int port_number; 1911 char handle[32]; 1912 int magic; /* Reserved */ 1913 int enabled; /* Reserved */ 1914 int caps; 1915#define MIXER_CAP_VIRTUAL 0x00000001 1916#define MIXER_CAP_LAYOUT_B 0x00000002 /* For internal use only */ 1917#define MIXER_CAP_NARROW 0x00000004 /* Conserve horiz space */ 1918 int flags; /* Reserved */ 1919 int nrext; 1920 /* 1921 * The priority field can be used to select the default (motherboard) 1922 * mixer device. The mixer with the highest priority is the 1923 * most preferred one. -2 or less means that this device cannot be used 1924 * as the default mixer. 1925 */ 1926 int priority; 1927 oss_devnode_t devnode; /* Device special file name (absolute path) */ 1928 int legacy_device; 1929 int filler[245]; /* Reserved */ 1930} oss_mixerinfo; 1931 1932typedef struct oss_midi_info 1933{ 1934 int dev; /* Midi device number */ 1935 char name[64]; 1936 int busy; /* 0, OPEN_READ, OPEN_WRITE or OPEN_READWRITE */ 1937 int pid; 1938 char cmd[64]; /* Command using the device (if known) */ 1939 int caps; 1940#define MIDI_CAP_MPU401 0x00000001 /**** OBSOLETE ****/ 1941#define MIDI_CAP_INPUT 0x00000002 1942#define MIDI_CAP_OUTPUT 0x00000004 1943#define MIDI_CAP_INOUT (MIDI_CAP_INPUT|MIDI_CAP_OUTPUT) 1944#define MIDI_CAP_VIRTUAL 0x00000008 /* Pseudo device */ 1945#define MIDI_CAP_MTCINPUT 0x00000010 /* Supports SNDCTL_MIDI_MTCINPUT */ 1946#define MIDI_CAP_CLIENT 0x00000020 /* Virtual client side device */ 1947#define MIDI_CAP_SERVER 0x00000040 /* Virtual server side device */ 1948#define MIDI_CAP_INTERNAL 0x00000080 /* Internal (synth) device */ 1949#define MIDI_CAP_EXTERNAL 0x00000100 /* external (MIDI port) device */ 1950#define MIDI_CAP_PTOP 0x00000200 /* Point to point link to one device */ 1951#define MIDI_CAP_MTC 0x00000400 /* MTC/SMPTE (control) device */ 1952 int magic; /* Reserved for internal use */ 1953 int card_number; 1954 int port_number; 1955 int enabled; /* 1=enabled, 0=device not ready at this moment */ 1956 int flags; /* For internal use only - no practical meaning */ 1957 char handle[32]; 1958 oss_longname_t song_name; /* Song name (if known) */ 1959 oss_label_t label; /* Device label (if given) */ 1960 int latency; /* In usecs, -1=unknown */ 1961 oss_devnode_t devnode; /* Device special file name (absolute path) */ 1962 int legacy_device; /* Legacy device mapping */ 1963 int filler[235]; 1964} oss_midi_info; 1965 1966typedef struct oss_card_info 1967{ 1968 int card; 1969 char shortname[16]; 1970 char longname[128]; 1971 int flags; 1972 int filler[256]; 1973} oss_card_info; 1974 1975#define SNDCTL_SYSINFO __SIOR ('X', 1, oss_sysinfo) 1976#define OSS_SYSINFO SNDCTL_SYSINFO /* Old name */ 1977 1978#define SNDCTL_MIX_NRMIX __SIOR ('X', 2, int) 1979#define SNDCTL_MIX_NREXT __SIOWR('X', 3, int) 1980#define SNDCTL_MIX_EXTINFO __SIOWR('X', 4, oss_mixext) 1981#define SNDCTL_MIX_READ __SIOWR('X', 5, oss_mixer_value) 1982#define SNDCTL_MIX_WRITE __SIOWR('X', 6, oss_mixer_value) 1983 1984#define SNDCTL_AUDIOINFO __SIOWR('X', 7, oss_audioinfo) 1985#define SNDCTL_MIX_ENUMINFO __SIOWR('X', 8, oss_mixer_enuminfo) 1986#define SNDCTL_MIDIINFO __SIOWR('X', 9, oss_midi_info) 1987#define SNDCTL_MIXERINFO __SIOWR('X',10, oss_mixerinfo) 1988#define SNDCTL_CARDINFO __SIOWR('X',11, oss_card_info) 1989#define SNDCTL_ENGINEINFO __SIOWR('X',12, oss_audioinfo) 1990#define SNDCTL_AUDIOINFO_EX __SIOWR('X',13, oss_audioinfo) 1991 1992/* ioctl codes 'X', 200-255 are reserved for internal use */ 1993 1994/* 1995 * Few more "globally" available ioctl calls. 1996 */ 1997#define SNDCTL_SETSONG __SIOW ('Y', 2, oss_longname_t) 1998#define SNDCTL_GETSONG __SIOR ('Y', 2, oss_longname_t) 1999#define SNDCTL_SETNAME __SIOW ('Y', 3, oss_longname_t) 2000#define SNDCTL_SETLABEL __SIOW ('Y', 4, oss_label_t) 2001#define SNDCTL_GETLABEL __SIOR ('Y', 4, oss_label_t) 2002/* 2003 * The "new" mixer API definitions end here. 2004 *************************************** 2005 */ 2006 2007/* 2008 ********************************************************* 2009 * Few routines that are included in -lOSSlib 2010 * 2011 * At this moment this interface is not used. OSSlib contains just 2012 * stubs that call the related system calls directly. 2013 */ 2014#ifdef OSSLIB 2015extern int osslib_open (const char *path, int flags, int dummy); 2016extern void osslib_close (int fd); 2017extern int osslib_write (int fd, const void *buf, int count); 2018extern int osslib_read (int fd, void *buf, int count); 2019extern int osslib_ioctl (int fd, unsigned int request, void *arg); 2020#else 2021# define osslib_open open 2022# define osslib_close close 2023# define osslib_write write 2024# define osslib_read read 2025# define osslib_ioctl ioctl 2026#endif 2027 2028#if 1 2029#define SNDCTL_DSP_NONBLOCK __SIO ('P',14) /* Obsolete. Not supported any more */ 2030#endif 2031 2032#if 1 2033/* 2034 * Some obsolete macros that are not part of Open Sound System API. 2035 */ 2036#define SOUND_PCM_READ_RATE SOUND_PCM_READ_RATE_is_obsolete 2037#define SOUND_PCM_READ_BITS SOUND_PCM_READ_BITS_is_obsolete 2038#define SOUND_PCM_READ_CHANNELS SOUND_PCM_READ_CHANNELS_is_obsolete 2039#define SOUND_PCM_WRITE_RATE SOUND_PCM_WRITE_RATE_is_obsolet_use_SNDCTL_DSP_SPEED_instead 2040#define SOUND_PCM_WRITE_CHANNELS SOUND_PCM_WRITE_CHANNELS_is_obsolete_use_SNDCTL_DSP_CHANNELS_instead 2041#define SOUND_PCM_WRITE_BITS SOUND_PCM_WRITE_BITS_is_obsolete_use_SNDCTL_DSP_SETFMT_instead 2042#define SOUND_PCM_POST SOUND_PCM_POST_is_obsolete_use_SNDCTL_DSP_POST_instead 2043#define SOUND_PCM_RESET SOUND_PCM_RESET_is_obsolete_use_SNDCTL_DSP_HALT_instead 2044#define SOUND_PCM_SYNC SOUND_PCM_SYNC_is_obsolete_use_SNDCTL_DSP_SYNC_instead 2045#define SOUND_PCM_SUBDIVIDE SOUND_PCM_SUBDIVIDE_is_obsolete_use_SNDCTL_DSP_SUBDIVIDE_instead 2046#define SOUND_PCM_SETFRAGMENT SOUND_PCM_SETFRAGMENT_is_obsolete_use_SNDCTL_DSP_SETFRAGMENT_instead 2047#define SOUND_PCM_GETFMTS SOUND_PCM_GETFMTS_is_obsolete_use_SNDCTL_DSP_GETFMTS_instead 2048#define SOUND_PCM_SETFMT SOUND_PCM_SETFMT_is_obsolete_use_SNDCTL_DSP_SETFMT_instead 2049#define SOUND_PCM_GETOSPACE SOUND_PCM_GETOSPACE_is_obsolete_use_SNDCTL_DSP_GETOSPACE_instead 2050#define SOUND_PCM_GETISPACE SOUND_PCM_GETISPACE_is_obsolete_use_SNDCTL_DSP_GETISPACE_instead 2051#define SOUND_PCM_NONBLOCK SOUND_PCM_NONBLOCK_is_obsolete_use_SNDCTL_DSP_NONBLOCK_instead 2052#define SOUND_PCM_GETCAPS SOUND_PCM_GETCAPS_is_obsolete_use_SNDCTL_DSP_GETCAPS_instead 2053#define SOUND_PCM_GETTRIGGER SOUND_PCM_GETTRIGGER_is_obsolete_use_SNDCTL_DSP_GETTRIGGER_instead 2054#define SOUND_PCM_SETTRIGGER SOUND_PCM_SETTRIGGER_is_obsolete_use_SNDCTL_DSP_SETTRIGGER_instead 2055#define SOUND_PCM_SETSYNCRO SOUND_PCM_SETSYNCRO_is_obsolete_use_SNDCTL_DSP_SETSYNCRO_instead 2056#define SOUND_PCM_GETIPTR SOUND_PCM_GETIPTR_is_obsolete_use_SNDCTL_DSP_GETIPTR_instead 2057#define SOUND_PCM_GETOPTR SOUND_PCM_GETOPTR_is_obsolete_use_SNDCTL_DSP_GETOPTR_instead 2058#define SOUND_PCM_MAPINBUF SOUND_PCM_MAPINBUF_is_obsolete_use_SNDCTL_DSP_MAPINBUF_instead 2059#define SOUND_PCM_MAPOUTBUF SOUND_PCM_MAPOUTBUF_is_obsolete_use_SNDCTL_DSP_MAPOUTBUF_instead 2060#endif 2061 2062#endif 2063