1 /** 2 * \file include/asoundef.h 3 * \brief Application interface library for the ALSA driver 4 * \author Jaroslav Kysela <perex (at) perex.cz> 5 * \author Abramo Bagnara <abramo (at) alsa-project.org> 6 * \author Takashi Iwai <tiwai (at) suse.de> 7 * \date 1998-2001 8 * 9 * Definitions of constants for the ALSA driver 10 */ 11 /* 12 * This library is free software; you can redistribute it and/or modify 13 * it under the terms of the GNU Lesser General Public License as 14 * published by the Free Software Foundation; either version 2.1 of 15 * the License, or (at your option) any later version. 16 * 17 * This program is distributed in the hope that it will be useful, 18 * but WITHOUT ANY WARRANTY; without even the implied warranty of 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 20 * GNU Lesser General Public License for more details. 21 * 22 * You should have received a copy of the GNU Lesser General Public 23 * License along with this library; if not, write to the Free Software 24 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 25 * 26 */ 27 28 #ifndef __ALSA_ASOUNDEF_H 29 #define __ALSA_ASOUNDEF_H 30 31 #ifdef __cplusplus 32 extern "C" { 33 #endif 34 35 /** 36 * \defgroup Digital_Audio_Interface Constants for Digital Audio Interfaces 37 * AES/IEC958 channel status bits. 38 * \{ 39 */ 40 41 #define IEC958_AES0_PROFESSIONAL (1<<0) /**< 0 = consumer, 1 = professional */ 42 #define IEC958_AES0_NONAUDIO (1<<1) /**< 0 = audio, 1 = non-audio */ 43 #define IEC958_AES0_PRO_EMPHASIS (7<<2) /**< mask - emphasis */ 44 #define IEC958_AES0_PRO_EMPHASIS_NOTID (0<<2) /**< emphasis not indicated */ 45 #define IEC958_AES0_PRO_EMPHASIS_NONE (1<<2) /**< no emphasis */ 46 #define IEC958_AES0_PRO_EMPHASIS_5015 (3<<2) /**< 50/15us emphasis */ 47 #define IEC958_AES0_PRO_EMPHASIS_CCITT (7<<2) /**< CCITT J.17 emphasis */ 48 #define IEC958_AES0_PRO_FREQ_UNLOCKED (1<<5) /**< source sample frequency: 0 = locked, 1 = unlocked */ 49 #define IEC958_AES0_PRO_FS (3<<6) /**< mask - sample frequency */ 50 #define IEC958_AES0_PRO_FS_NOTID (0<<6) /**< fs not indicated */ 51 #define IEC958_AES0_PRO_FS_44100 (1<<6) /**< 44.1kHz */ 52 #define IEC958_AES0_PRO_FS_48000 (2<<6) /**< 48kHz */ 53 #define IEC958_AES0_PRO_FS_32000 (3<<6) /**< 32kHz */ 54 #define IEC958_AES0_CON_NOT_COPYRIGHT (1<<2) /**< 0 = copyright, 1 = not copyright */ 55 #define IEC958_AES0_CON_EMPHASIS (7<<3) /**< mask - emphasis */ 56 #define IEC958_AES0_CON_EMPHASIS_NONE (0<<3) /**< no emphasis */ 57 #define IEC958_AES0_CON_EMPHASIS_5015 (1<<3) /**< 50/15us emphasis */ 58 #define IEC958_AES0_CON_MODE (3<<6) /**< mask - mode */ 59 #define IEC958_AES1_PRO_MODE (15<<0) /**< mask - channel mode */ 60 #define IEC958_AES1_PRO_MODE_NOTID (0<<0) /**< mode not indicated */ 61 #define IEC958_AES1_PRO_MODE_STEREOPHONIC (2<<0) /**< stereophonic - ch A is left */ 62 #define IEC958_AES1_PRO_MODE_SINGLE (4<<0) /**< single channel */ 63 #define IEC958_AES1_PRO_MODE_TWO (8<<0) /**< two channels */ 64 #define IEC958_AES1_PRO_MODE_PRIMARY (12<<0) /**< primary/secondary */ 65 #define IEC958_AES1_PRO_MODE_BYTE3 (15<<0) /**< vector to byte 3 */ 66 #define IEC958_AES1_PRO_USERBITS (15<<4) /**< mask - user bits */ 67 #define IEC958_AES1_PRO_USERBITS_NOTID (0<<4) /**< user bits not indicated */ 68 #define IEC958_AES1_PRO_USERBITS_192 (8<<4) /**< 192-bit structure */ 69 #define IEC958_AES1_PRO_USERBITS_UDEF (12<<4) /**< user defined application */ 70 #define IEC958_AES1_CON_CATEGORY 0x7f /**< consumer category */ 71 #define IEC958_AES1_CON_GENERAL 0x00 /**< general category */ 72 #define IEC958_AES1_CON_EXPERIMENTAL 0x40 /**< experimental category */ 73 #define IEC958_AES1_CON_SOLIDMEM_MASK 0x0f /**< ??? */ 74 #define IEC958_AES1_CON_SOLIDMEM_ID 0x08 /**< ??? */ 75 #define IEC958_AES1_CON_BROADCAST1_MASK 0x07 /**< ??? */ 76 #define IEC958_AES1_CON_BROADCAST1_ID 0x04 /**< ??? */ 77 #define IEC958_AES1_CON_DIGDIGCONV_MASK 0x07 /**< digital<->digital converter mask */ 78 #define IEC958_AES1_CON_DIGDIGCONV_ID 0x02 /**< digital<->digital converter id */ 79 #define IEC958_AES1_CON_ADC_COPYRIGHT_MASK 0x1f /**< ADC Copyright mask */ 80 #define IEC958_AES1_CON_ADC_COPYRIGHT_ID 0x06 /**< ADC Copyright ID */ 81 #define IEC958_AES1_CON_ADC_MASK 0x1f /**< ADC Mask */ 82 #define IEC958_AES1_CON_ADC_ID 0x16 /**< ADC ID */ 83 #define IEC958_AES1_CON_BROADCAST2_MASK 0x0f /**< Broadcast mask */ 84 #define IEC958_AES1_CON_BROADCAST2_ID 0x0e /**< Broadcast ID */ 85 #define IEC958_AES1_CON_LASEROPT_MASK 0x07 /**< Laser-optical mask */ 86 #define IEC958_AES1_CON_LASEROPT_ID 0x01 /**< Laser-optical ID */ 87 #define IEC958_AES1_CON_MUSICAL_MASK 0x07 /**< Musical device mask */ 88 #define IEC958_AES1_CON_MUSICAL_ID 0x05 /**< Musical device ID */ 89 #define IEC958_AES1_CON_MAGNETIC_MASK 0x07 /**< Magnetic device mask */ 90 #define IEC958_AES1_CON_MAGNETIC_ID 0x03 /**< Magnetic device ID */ 91 #define IEC958_AES1_CON_IEC908_CD (IEC958_AES1_CON_LASEROPT_ID|0x00) /**< IEC958 CD compatible device */ 92 #define IEC958_AES1_CON_NON_IEC908_CD (IEC958_AES1_CON_LASEROPT_ID|0x08) /**< non-IEC958 CD compatible device */ 93 #define IEC958_AES1_CON_PCM_CODER (IEC958_AES1_CON_DIGDIGCONV_ID|0x00) /**< PCM coder */ 94 #define IEC958_AES1_CON_SAMPLER (IEC958_AES1_CON_DIGDIGCONV_ID|0x20) /**< PCM sampler */ 95 #define IEC958_AES1_CON_MIXER (IEC958_AES1_CON_DIGDIGCONV_ID|0x10) /**< Mixer */ 96 #define IEC958_AES1_CON_RATE_CONVERTER (IEC958_AES1_CON_DIGDIGCONV_ID|0x18) /**< Rate converter */ 97 #define IEC958_AES1_CON_SYNTHESIZER (IEC958_AES1_CON_MUSICAL_ID|0x00) /**< Synthesizer */ 98 #define IEC958_AES1_CON_MICROPHONE (IEC958_AES1_CON_MUSICAL_ID|0x08) /**< Microphone */ 99 #define IEC958_AES1_CON_DAT (IEC958_AES1_CON_MAGNETIC_ID|0x00) /**< Digital Audio Tape */ 100 #define IEC958_AES1_CON_VCR (IEC958_AES1_CON_MAGNETIC_ID|0x08) /**< Video recorder */ 101 #define IEC958_AES1_CON_ORIGINAL (1<<7) /**< this bits depends on the category code */ 102 #define IEC958_AES2_PRO_SBITS (7<<0) /**< mask - sample bits */ 103 #define IEC958_AES2_PRO_SBITS_20 (2<<0) /**< 20-bit - coordination */ 104 #define IEC958_AES2_PRO_SBITS_24 (4<<0) /**< 24-bit - main audio */ 105 #define IEC958_AES2_PRO_SBITS_UDEF (6<<0) /**< user defined application */ 106 #define IEC958_AES2_PRO_WORDLEN (7<<3) /**< mask - source word length */ 107 #define IEC958_AES2_PRO_WORDLEN_NOTID (0<<3) /**< source word length not indicated */ 108 #define IEC958_AES2_PRO_WORDLEN_22_18 (2<<3) /**< 22-bit or 18-bit */ 109 #define IEC958_AES2_PRO_WORDLEN_23_19 (4<<3) /**< 23-bit or 19-bit */ 110 #define IEC958_AES2_PRO_WORDLEN_24_20 (5<<3) /**< 24-bit or 20-bit */ 111 #define IEC958_AES2_PRO_WORDLEN_20_16 (6<<3) /**< 20-bit or 16-bit */ 112 #define IEC958_AES2_CON_SOURCE (15<<0) /**< mask - source number */ 113 #define IEC958_AES2_CON_SOURCE_UNSPEC (0<<0) /**< source number unspecified */ 114 #define IEC958_AES2_CON_CHANNEL (15<<4) /**< mask - channel number */ 115 #define IEC958_AES2_CON_CHANNEL_UNSPEC (0<<4) /**< channel number unspecified */ 116 #define IEC958_AES3_CON_FS (15<<0) /**< mask - sample frequency */ 117 #define IEC958_AES3_CON_FS_44100 (0<<0) /**< 44.1kHz */ 118 #define IEC958_AES3_CON_FS_48000 (2<<0) /**< 48kHz */ 119 #define IEC958_AES3_CON_FS_32000 (3<<0) /**< 32kHz */ 120 #define IEC958_AES3_CON_CLOCK (3<<4) /**< mask - clock accuracy */ 121 #define IEC958_AES3_CON_CLOCK_1000PPM (0<<4) /**< 1000 ppm */ 122 #define IEC958_AES3_CON_CLOCK_50PPM (1<<4) /**< 50 ppm */ 123 #define IEC958_AES3_CON_CLOCK_VARIABLE (2<<4) /**< variable pitch */ 124 125 /** \} */ 126 127 /** 128 * \defgroup MIDI_Interface Constants for MIDI v1.0 129 * Constants for MIDI v1.0. 130 * \{ 131 */ 132 133 #define MIDI_CHANNELS 16 /**< Number of channels per port/cable. */ 134 #define MIDI_GM_DRUM_CHANNEL (10-1) /**< Channel number for GM drums. */ 135 136 /** 137 * \defgroup MIDI_Commands MIDI Commands 138 * MIDI command codes. 139 * \{ 140 */ 141 142 #define MIDI_CMD_NOTE_OFF 0x80 /**< note off */ 143 #define MIDI_CMD_NOTE_ON 0x90 /**< note on */ 144 #define MIDI_CMD_NOTE_PRESSURE 0xa0 /**< key pressure */ 145 #define MIDI_CMD_CONTROL 0xb0 /**< control change */ 146 #define MIDI_CMD_PGM_CHANGE 0xc0 /**< program change */ 147 #define MIDI_CMD_CHANNEL_PRESSURE 0xd0 /**< channel pressure */ 148 #define MIDI_CMD_BENDER 0xe0 /**< pitch bender */ 149 150 #define MIDI_CMD_COMMON_SYSEX 0xf0 /**< sysex (system exclusive) begin */ 151 #define MIDI_CMD_COMMON_MTC_QUARTER 0xf1 /**< MTC quarter frame */ 152 #define MIDI_CMD_COMMON_SONG_POS 0xf2 /**< song position */ 153 #define MIDI_CMD_COMMON_SONG_SELECT 0xf3 /**< song select */ 154 #define MIDI_CMD_COMMON_TUNE_REQUEST 0xf6 /**< tune request */ 155 #define MIDI_CMD_COMMON_SYSEX_END 0xf7 /**< end of sysex */ 156 #define MIDI_CMD_COMMON_CLOCK 0xf8 /**< clock */ 157 #define MIDI_CMD_COMMON_START 0xfa /**< start */ 158 #define MIDI_CMD_COMMON_CONTINUE 0xfb /**< continue */ 159 #define MIDI_CMD_COMMON_STOP 0xfc /**< stop */ 160 #define MIDI_CMD_COMMON_SENSING 0xfe /**< active sensing */ 161 #define MIDI_CMD_COMMON_RESET 0xff /**< reset */ 162 163 /** \} */ 164 165 /** 166 * \defgroup MIDI_Controllers MIDI Controllers 167 * MIDI controller numbers. 168 * \{ 169 */ 170 171 #define MIDI_CTL_MSB_BANK 0x00 /**< Bank selection */ 172 #define MIDI_CTL_MSB_MODWHEEL 0x01 /**< Modulation */ 173 #define MIDI_CTL_MSB_BREATH 0x02 /**< Breath */ 174 #define MIDI_CTL_MSB_FOOT 0x04 /**< Foot */ 175 #define MIDI_CTL_MSB_PORTAMENTO_TIME 0x05 /**< Portamento time */ 176 #define MIDI_CTL_MSB_DATA_ENTRY 0x06 /**< Data entry */ 177 #define MIDI_CTL_MSB_MAIN_VOLUME 0x07 /**< Main volume */ 178 #define MIDI_CTL_MSB_BALANCE 0x08 /**< Balance */ 179 #define MIDI_CTL_MSB_PAN 0x0a /**< Panpot */ 180 #define MIDI_CTL_MSB_EXPRESSION 0x0b /**< Expression */ 181 #define MIDI_CTL_MSB_EFFECT1 0x0c /**< Effect1 */ 182 #define MIDI_CTL_MSB_EFFECT2 0x0d /**< Effect2 */ 183 #define MIDI_CTL_MSB_GENERAL_PURPOSE1 0x10 /**< General purpose 1 */ 184 #define MIDI_CTL_MSB_GENERAL_PURPOSE2 0x11 /**< General purpose 2 */ 185 #define MIDI_CTL_MSB_GENERAL_PURPOSE3 0x12 /**< General purpose 3 */ 186 #define MIDI_CTL_MSB_GENERAL_PURPOSE4 0x13 /**< General purpose 4 */ 187 #define MIDI_CTL_LSB_BANK 0x20 /**< Bank selection */ 188 #define MIDI_CTL_LSB_MODWHEEL 0x21 /**< Modulation */ 189 #define MIDI_CTL_LSB_BREATH 0x22 /**< Breath */ 190 #define MIDI_CTL_LSB_FOOT 0x24 /**< Foot */ 191 #define MIDI_CTL_LSB_PORTAMENTO_TIME 0x25 /**< Portamento time */ 192 #define MIDI_CTL_LSB_DATA_ENTRY 0x26 /**< Data entry */ 193 #define MIDI_CTL_LSB_MAIN_VOLUME 0x27 /**< Main volume */ 194 #define MIDI_CTL_LSB_BALANCE 0x28 /**< Balance */ 195 #define MIDI_CTL_LSB_PAN 0x2a /**< Panpot */ 196 #define MIDI_CTL_LSB_EXPRESSION 0x2b /**< Expression */ 197 #define MIDI_CTL_LSB_EFFECT1 0x2c /**< Effect1 */ 198 #define MIDI_CTL_LSB_EFFECT2 0x2d /**< Effect2 */ 199 #define MIDI_CTL_LSB_GENERAL_PURPOSE1 0x30 /**< General purpose 1 */ 200 #define MIDI_CTL_LSB_GENERAL_PURPOSE2 0x31 /**< General purpose 2 */ 201 #define MIDI_CTL_LSB_GENERAL_PURPOSE3 0x32 /**< General purpose 3 */ 202 #define MIDI_CTL_LSB_GENERAL_PURPOSE4 0x33 /**< General purpose 4 */ 203 #define MIDI_CTL_SUSTAIN 0x40 /**< Sustain pedal */ 204 #define MIDI_CTL_PORTAMENTO 0x41 /**< Portamento */ 205 #define MIDI_CTL_SOSTENUTO 0x42 /**< Sostenuto */ 206 #define MIDI_CTL_SUSTENUTO 0x42 /**< Sostenuto (a typo in the older version) */ 207 #define MIDI_CTL_SOFT_PEDAL 0x43 /**< Soft pedal */ 208 #define MIDI_CTL_LEGATO_FOOTSWITCH 0x44 /**< Legato foot switch */ 209 #define MIDI_CTL_HOLD2 0x45 /**< Hold2 */ 210 #define MIDI_CTL_SC1_SOUND_VARIATION 0x46 /**< SC1 Sound Variation */ 211 #define MIDI_CTL_SC2_TIMBRE 0x47 /**< SC2 Timbre */ 212 #define MIDI_CTL_SC3_RELEASE_TIME 0x48 /**< SC3 Release Time */ 213 #define MIDI_CTL_SC4_ATTACK_TIME 0x49 /**< SC4 Attack Time */ 214 #define MIDI_CTL_SC5_BRIGHTNESS 0x4a /**< SC5 Brightness */ 215 #define MIDI_CTL_SC6 0x4b /**< SC6 */ 216 #define MIDI_CTL_SC7 0x4c /**< SC7 */ 217 #define MIDI_CTL_SC8 0x4d /**< SC8 */ 218 #define MIDI_CTL_SC9 0x4e /**< SC9 */ 219 #define MIDI_CTL_SC10 0x4f /**< SC10 */ 220 #define MIDI_CTL_GENERAL_PURPOSE5 0x50 /**< General purpose 5 */ 221 #define MIDI_CTL_GENERAL_PURPOSE6 0x51 /**< General purpose 6 */ 222 #define MIDI_CTL_GENERAL_PURPOSE7 0x52 /**< General purpose 7 */ 223 #define MIDI_CTL_GENERAL_PURPOSE8 0x53 /**< General purpose 8 */ 224 #define MIDI_CTL_PORTAMENTO_CONTROL 0x54 /**< Portamento control */ 225 #define MIDI_CTL_E1_REVERB_DEPTH 0x5b /**< E1 Reverb Depth */ 226 #define MIDI_CTL_E2_TREMOLO_DEPTH 0x5c /**< E2 Tremolo Depth */ 227 #define MIDI_CTL_E3_CHORUS_DEPTH 0x5d /**< E3 Chorus Depth */ 228 #define MIDI_CTL_E4_DETUNE_DEPTH 0x5e /**< E4 Detune Depth */ 229 #define MIDI_CTL_E5_PHASER_DEPTH 0x5f /**< E5 Phaser Depth */ 230 #define MIDI_CTL_DATA_INCREMENT 0x60 /**< Data Increment */ 231 #define MIDI_CTL_DATA_DECREMENT 0x61 /**< Data Decrement */ 232 #define MIDI_CTL_NONREG_PARM_NUM_LSB 0x62 /**< Non-registered parameter number */ 233 #define MIDI_CTL_NONREG_PARM_NUM_MSB 0x63 /**< Non-registered parameter number */ 234 #define MIDI_CTL_REGIST_PARM_NUM_LSB 0x64 /**< Registered parameter number */ 235 #define MIDI_CTL_REGIST_PARM_NUM_MSB 0x65 /**< Registered parameter number */ 236 #define MIDI_CTL_ALL_SOUNDS_OFF 0x78 /**< All sounds off */ 237 #define MIDI_CTL_RESET_CONTROLLERS 0x79 /**< Reset Controllers */ 238 #define MIDI_CTL_LOCAL_CONTROL_SWITCH 0x7a /**< Local control switch */ 239 #define MIDI_CTL_ALL_NOTES_OFF 0x7b /**< All notes off */ 240 #define MIDI_CTL_OMNI_OFF 0x7c /**< Omni off */ 241 #define MIDI_CTL_OMNI_ON 0x7d /**< Omni on */ 242 #define MIDI_CTL_MONO1 0x7e /**< Mono1 */ 243 #define MIDI_CTL_MONO2 0x7f /**< Mono2 */ 244 245 /** \} */ 246 247 /** \} */ 248 249 #ifdef __cplusplus 250 } 251 #endif 252 253 #endif /* __ALSA_ASOUNDEF_H */ 254
