1 #ifndef __SOUND_SFNT_INFO_H 2 #define __SOUND_SFNT_INFO_H 3 4 /* 5 * Patch record compatible with AWE driver on OSS 6 * 7 * Copyright (C) 1999-2000 Takashi Iwai 8 * 9 * This program is free software; you can redistribute it and/or modify 10 * it under the terms of the GNU General Public License as published by 11 * the Free Software Foundation; either version 2 of the License, or 12 * (at your option) any later version. 13 * 14 * This program is distributed in the hope that it will be useful, 15 * but WITHOUT ANY WARRANTY; without even the implied warranty of 16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 17 * GNU General Public License for more details. 18 * 19 * You should have received a copy of the GNU General Public License 20 * along with this program; if not, write to the Free Software 21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 22 * 23 */ 24 25 #include <sound/asound.h> 26 27 /* 28 * patch information record 29 */ 30 31 #ifdef SNDRV_BIG_ENDIAN 32 #define SNDRV_OSS_PATCHKEY(id) (0xfd00|id) 33 #else 34 #define SNDRV_OSS_PATCHKEY(id) ((id<<8)|0xfd) 35 #endif 36 37 /* patch interface header: 16 bytes */ 38 struct soundfont_patch_info { 39 unsigned short key; /* use the key below */ 40 #define SNDRV_OSS_SOUNDFONT_PATCH SNDRV_OSS_PATCHKEY(0x07) 41 42 short device_no; /* synthesizer number */ 43 unsigned short sf_id; /* file id (should be zero) */ 44 short optarg; /* optional argument */ 45 int len; /* data length (without this header) */ 46 47 short type; /* patch operation type */ 48 #define SNDRV_SFNT_LOAD_INFO 0 /* awe_voice_rec */ 49 #define SNDRV_SFNT_LOAD_DATA 1 /* awe_sample_info */ 50 #define SNDRV_SFNT_OPEN_PATCH 2 /* awe_open_parm */ 51 #define SNDRV_SFNT_CLOSE_PATCH 3 /* none */ 52 /* 4 is obsolete */ 53 #define SNDRV_SFNT_REPLACE_DATA 5 /* awe_sample_info (optarg=#channels)*/ 54 #define SNDRV_SFNT_MAP_PRESET 6 /* awe_voice_map */ 55 /* 7 is not used */ 56 #define SNDRV_SFNT_PROBE_DATA 8 /* optarg=sample */ 57 #define SNDRV_SFNT_REMOVE_INFO 9 /* optarg=(bank<<8)|instr */ 58 59 short reserved; /* word alignment data */ 60 61 /* the actual patch data begins after this */ 62 }; 63 64 65 /* 66 * open patch 67 */ 68 69 #define SNDRV_SFNT_PATCH_NAME_LEN 32 70 71 struct soundfont_open_parm { 72 unsigned short type; /* sample type */ 73 #define SNDRV_SFNT_PAT_TYPE_MISC 0 74 #define SNDRV_SFNT_PAT_TYPE_GUS 6 75 #define SNDRV_SFNT_PAT_TYPE_MAP 7 76 #define SNDRV_SFNT_PAT_LOCKED 0x100 /* lock the samples */ 77 #define SNDRV_SFNT_PAT_SHARED 0x200 /* sample is shared */ 78 79 short reserved; 80 char name[SNDRV_SFNT_PATCH_NAME_LEN]; 81 }; 82 83 84 /* 85 * raw voice information record 86 */ 87 88 /* wave table envelope & effect parameters to control EMU8000 */ 89 struct soundfont_voice_parm { 90 unsigned short moddelay; /* modulation delay (0x8000) */ 91 unsigned short modatkhld; /* modulation attack & hold time (0x7f7f) */ 92 unsigned short moddcysus; /* modulation decay & sustain (0x7f7f) */ 93 unsigned short modrelease; /* modulation release time (0x807f) */ 94 short modkeyhold, modkeydecay; /* envelope change per key (not used) */ 95 unsigned short voldelay; /* volume delay (0x8000) */ 96 unsigned short volatkhld; /* volume attack & hold time (0x7f7f) */ 97 unsigned short voldcysus; /* volume decay & sustain (0x7f7f) */ 98 unsigned short volrelease; /* volume release time (0x807f) */ 99 short volkeyhold, volkeydecay; /* envelope change per key (not used) */ 100 unsigned short lfo1delay; /* LFO1 delay (0x8000) */ 101 unsigned short lfo2delay; /* LFO2 delay (0x8000) */ 102 unsigned short pefe; /* modulation pitch & cutoff (0x0000) */ 103 unsigned short fmmod; /* LFO1 pitch & cutoff (0x0000) */ 104 unsigned short tremfrq; /* LFO1 volume & freq (0x0000) */ 105 unsigned short fm2frq2; /* LFO2 pitch & freq (0x0000) */ 106 unsigned char cutoff; /* initial cutoff (0xff) */ 107 unsigned char filterQ; /* initial filter Q [0-15] (0x0) */ 108 unsigned char chorus; /* chorus send (0x00) */ 109 unsigned char reverb; /* reverb send (0x00) */ 110 unsigned short reserved[4]; /* not used */ 111 }; 112 113 114 /* wave table parameters: 92 bytes */ 115 struct soundfont_voice_info { 116 unsigned short sf_id; /* file id (should be zero) */ 117 unsigned short sample; /* sample id */ 118 int start, end; /* sample offset correction */ 119 int loopstart, loopend; /* loop offset correction */ 120 short rate_offset; /* sample rate pitch offset */ 121 unsigned short mode; /* sample mode */ 122 #define SNDRV_SFNT_MODE_ROMSOUND 0x8000 123 #define SNDRV_SFNT_MODE_STEREO 1 124 #define SNDRV_SFNT_MODE_LOOPING 2 125 #define SNDRV_SFNT_MODE_NORELEASE 4 /* obsolete */ 126 #define SNDRV_SFNT_MODE_INIT_PARM 8 127 128 short root; /* midi root key */ 129 short tune; /* pitch tuning (in cents) */ 130 unsigned char low, high; /* key note range */ 131 unsigned char vellow, velhigh; /* velocity range */ 132 signed char fixkey, fixvel; /* fixed key, velocity */ 133 signed char pan, fixpan; /* panning, fixed panning */ 134 short exclusiveClass; /* exclusive class (0 = none) */ 135 unsigned char amplitude; /* sample volume (127 max) */ 136 unsigned char attenuation; /* attenuation (0.375dB) */ 137 short scaleTuning; /* pitch scale tuning(%), normally 100 */ 138 struct soundfont_voice_parm parm; /* voice envelope parameters */ 139 unsigned short sample_mode; /* sample mode_flag (set by driver) */ 140 }; 141 142 143 /* instrument info header: 4 bytes */ 144 struct soundfont_voice_rec_hdr { 145 unsigned char bank; /* midi bank number */ 146 unsigned char instr; /* midi preset number */ 147 char nvoices; /* number of voices */ 148 char write_mode; /* write mode; normally 0 */ 149 #define SNDRV_SFNT_WR_APPEND 0 /* append anyway */ 150 #define SNDRV_SFNT_WR_EXCLUSIVE 1 /* skip if already exists */ 151 #define SNDRV_SFNT_WR_REPLACE 2 /* replace if already exists */ 152 }; 153 154 155 /* 156 * sample wave information 157 */ 158 159 /* wave table sample header: 32 bytes */ 160 struct soundfont_sample_info { 161 unsigned short sf_id; /* file id (should be zero) */ 162 unsigned short sample; /* sample id */ 163 int start, end; /* start & end offset */ 164 int loopstart, loopend; /* loop start & end offset */ 165 int size; /* size (0 = ROM) */ 166 short dummy; /* not used */ 167 unsigned short mode_flags; /* mode flags */ 168 #define SNDRV_SFNT_SAMPLE_8BITS 1 /* wave data is 8bits */ 169 #define SNDRV_SFNT_SAMPLE_UNSIGNED 2 /* wave data is unsigned */ 170 #define SNDRV_SFNT_SAMPLE_NO_BLANK 4 /* no blank loop is attached */ 171 #define SNDRV_SFNT_SAMPLE_SINGLESHOT 8 /* single-shot w/o loop */ 172 #define SNDRV_SFNT_SAMPLE_BIDIR_LOOP 16 /* bidirectional looping */ 173 #define SNDRV_SFNT_SAMPLE_STEREO_LEFT 32 /* stereo left sound */ 174 #define SNDRV_SFNT_SAMPLE_STEREO_RIGHT 64 /* stereo right sound */ 175 #define SNDRV_SFNT_SAMPLE_REVERSE_LOOP 128 /* reverse looping */ 176 unsigned int truesize; /* used memory size (set by driver) */ 177 }; 178 179 180 /* 181 * voice preset mapping (aliasing) 182 */ 183 184 struct soundfont_voice_map { 185 int map_bank, map_instr, map_key; /* key = -1 means all keys */ 186 int src_bank, src_instr, src_key; 187 }; 188 189 190 /* 191 * ioctls for hwdep 192 */ 193 194 #define SNDRV_EMUX_HWDEP_NAME "Emux WaveTable" 195 196 #define SNDRV_EMUX_VERSION ((1 << 16) | (0 << 8) | 0) /* 1.0.0 */ 197 198 struct snd_emux_misc_mode { 199 int port; /* -1 = all */ 200 int mode; 201 int value; 202 int value2; /* reserved */ 203 }; 204 205 #define SNDRV_EMUX_IOCTL_VERSION _IOR('H', 0x80, unsigned int) 206 #define SNDRV_EMUX_IOCTL_LOAD_PATCH _IOWR('H', 0x81, struct soundfont_patch_info) 207 #define SNDRV_EMUX_IOCTL_RESET_SAMPLES _IO('H', 0x82) 208 #define SNDRV_EMUX_IOCTL_REMOVE_LAST_SAMPLES _IO('H', 0x83) 209 #define SNDRV_EMUX_IOCTL_MEM_AVAIL _IOW('H', 0x84, int) 210 #define SNDRV_EMUX_IOCTL_MISC_MODE _IOWR('H', 0x84, struct snd_emux_misc_mode) 211 212 #endif /* __SOUND_SFNT_INFO_H */ 213