1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * NRPN / SYSEX callbacks for Emu8k/Emu10k1
4 *
5 * Copyright (c) 1999-2000 Takashi Iwai <tiwai@suse.de>
6 */
7
8 #include "emux_voice.h"
9 #include <sound/asoundef.h>
10
11 /*
12 * conversion from NRPN/control parameters to Emu8000 raw parameters
13 */
14
15 /* NRPN / CC -> Emu8000 parameter converter */
16 struct nrpn_conv_table {
17 int control;
18 int effect;
19 int (*convert)(int val);
20 };
21
22 /* effect sensitivity */
23
24 #define FX_CUTOFF 0
25 #define FX_RESONANCE 1
26 #define FX_ATTACK 2
27 #define FX_RELEASE 3
28 #define FX_VIBRATE 4
29 #define FX_VIBDEPTH 5
30 #define FX_VIBDELAY 6
31 #define FX_NUMS 7
32
33 /*
34 * convert NRPN/control values
35 */
36
37 static int send_converted_effect(const struct nrpn_conv_table *table,
38 int num_tables,
39 struct snd_emux_port *port,
40 struct snd_midi_channel *chan,
41 int type, int val, int mode)
42 {
43 int i, cval;
44 for (i = 0; i < num_tables; i++) {
45 if (table[i].control == type) {
46 cval = table[i].convert(val);
47 snd_emux_send_effect(port, chan, table[i].effect,
48 cval, mode);
49 return 1;
50 }
51 }
52 return 0;
53 }
54
55 #define DEF_FX_CUTOFF 170
56 #define DEF_FX_RESONANCE 6
57 #define DEF_FX_ATTACK 50
58 #define DEF_FX_RELEASE 50
59 #define DEF_FX_VIBRATE 30
60 #define DEF_FX_VIBDEPTH 4
61 #define DEF_FX_VIBDELAY 1500
62
63 /* effect sensitivities for GS NRPN:
64 * adjusted for chaos 8MB soundfonts
65 */
66 static const int gs_sense[] =
67 {
68 DEF_FX_CUTOFF, DEF_FX_RESONANCE, DEF_FX_ATTACK, DEF_FX_RELEASE,
69 DEF_FX_VIBRATE, DEF_FX_VIBDEPTH, DEF_FX_VIBDELAY
70 };
71
72 /* effect sensitivities for XG controls:
73 * adjusted for chaos 8MB soundfonts
74 */
75 static const int xg_sense[] =
76 {
77 DEF_FX_CUTOFF, DEF_FX_RESONANCE, DEF_FX_ATTACK, DEF_FX_RELEASE,
78 DEF_FX_VIBRATE, DEF_FX_VIBDEPTH, DEF_FX_VIBDELAY
79 };
80
81
82 /*
83 * AWE32 NRPN effects
84 */
85
86 static int fx_delay(int val);
87 static int fx_attack(int val);
88 static int fx_hold(int val);
89 static int fx_decay(int val);
90 static int fx_the_value(int val);
91 static int fx_twice_value(int val);
92 static int fx_conv_pitch(int val);
93 static int fx_conv_Q(int val);
94
95 /* function for each NRPN */ /* [range] units */
96 #define fx_env1_delay fx_delay /* [0,5900] 4msec */
97 #define fx_env1_attack fx_attack /* [0,5940] 1msec */
98 #define fx_env1_hold fx_hold /* [0,8191] 1msec */
99 #define fx_env1_decay fx_decay /* [0,5940] 4msec */
100 #define fx_env1_release fx_decay /* [0,5940] 4msec */
101 #define fx_env1_sustain fx_the_value /* [0,127] 0.75dB */
102 #define fx_env1_pitch fx_the_value /* [-127,127] 9.375cents */
103 #define fx_env1_cutoff fx_the_value /* [-127,127] 56.25cents */
104
105 #define fx_env2_delay fx_delay /* [0,5900] 4msec */
106 #define fx_env2_attack fx_attack /* [0,5940] 1msec */
107 #define fx_env2_hold fx_hold /* [0,8191] 1msec */
108 #define fx_env2_decay fx_decay /* [0,5940] 4msec */
109 #define fx_env2_release fx_decay /* [0,5940] 4msec */
110 #define fx_env2_sustain fx_the_value /* [0,127] 0.75dB */
111
112 #define fx_lfo1_delay fx_delay /* [0,5900] 4msec */
113 #define fx_lfo1_freq fx_twice_value /* [0,127] 84mHz */
114 #define fx_lfo1_volume fx_twice_value /* [0,127] 0.1875dB */
115 #define fx_lfo1_pitch fx_the_value /* [-127,127] 9.375cents */
116 #define fx_lfo1_cutoff fx_twice_value /* [-64,63] 56.25cents */
117
118 #define fx_lfo2_delay fx_delay /* [0,5900] 4msec */
119 #define fx_lfo2_freq fx_twice_value /* [0,127] 84mHz */
120 #define fx_lfo2_pitch fx_the_value /* [-127,127] 9.375cents */
121
122 #define fx_init_pitch fx_conv_pitch /* [-8192,8192] cents */
123 #define fx_chorus fx_the_value /* [0,255] -- */
124 #define fx_reverb fx_the_value /* [0,255] -- */
125 #define fx_cutoff fx_twice_value /* [0,127] 62Hz */
126 #define fx_filterQ fx_conv_Q /* [0,127] -- */
127
128 static int fx_delay(int val)
129 {
130 return (unsigned short)snd_sf_calc_parm_delay(val);
131 }
132
133 static int fx_attack(int val)
134 {
135 return (unsigned short)snd_sf_calc_parm_attack(val);
136 }
137
138 static int fx_hold(int val)
139 {
140 return (unsigned short)snd_sf_calc_parm_hold(val);
141 }
142
143 static int fx_decay(int val)
144 {
145 return (unsigned short)snd_sf_calc_parm_decay(val);
146 }
147
148 static int fx_the_value(int val)
149 {
150 return (unsigned short)(val & 0xff);
151 }
152
153 static int fx_twice_value(int val)
154 {
155 return (unsigned short)((val * 2) & 0xff);
156 }
157
158 static int fx_conv_pitch(int val)
159 {
160 return (short)(val * 4096 / 1200);
161 }
162
163 static int fx_conv_Q(int val)
164 {
165 return (unsigned short)((val / 8) & 0xff);
166 }
167
168
169 static const struct nrpn_conv_table awe_effects[] =
170 {
171 { 0, EMUX_FX_LFO1_DELAY, fx_lfo1_delay},
172 { 1, EMUX_FX_LFO1_FREQ, fx_lfo1_freq},
173 { 2, EMUX_FX_LFO2_DELAY, fx_lfo2_delay},
174 { 3, EMUX_FX_LFO2_FREQ, fx_lfo2_freq},
175
176 { 4, EMUX_FX_ENV1_DELAY, fx_env1_delay},
177 { 5, EMUX_FX_ENV1_ATTACK,fx_env1_attack},
178 { 6, EMUX_FX_ENV1_HOLD, fx_env1_hold},
179 { 7, EMUX_FX_ENV1_DECAY, fx_env1_decay},
180 { 8, EMUX_FX_ENV1_SUSTAIN, fx_env1_sustain},
181 { 9, EMUX_FX_ENV1_RELEASE, fx_env1_release},
182
183 {10, EMUX_FX_ENV2_DELAY, fx_env2_delay},
184 {11, EMUX_FX_ENV2_ATTACK, fx_env2_attack},
185 {12, EMUX_FX_ENV2_HOLD, fx_env2_hold},
186 {13, EMUX_FX_ENV2_DECAY, fx_env2_decay},
187 {14, EMUX_FX_ENV2_SUSTAIN, fx_env2_sustain},
188 {15, EMUX_FX_ENV2_RELEASE, fx_env2_release},
189
190 {16, EMUX_FX_INIT_PITCH, fx_init_pitch},
191 {17, EMUX_FX_LFO1_PITCH, fx_lfo1_pitch},
192 {18, EMUX_FX_LFO2_PITCH, fx_lfo2_pitch},
193 {19, EMUX_FX_ENV1_PITCH, fx_env1_pitch},
194 {20, EMUX_FX_LFO1_VOLUME, fx_lfo1_volume},
195 {21, EMUX_FX_CUTOFF, fx_cutoff},
196 {22, EMUX_FX_FILTERQ, fx_filterQ},
197 {23, EMUX_FX_LFO1_CUTOFF, fx_lfo1_cutoff},
198 {24, EMUX_FX_ENV1_CUTOFF, fx_env1_cutoff},
199 {25, EMUX_FX_CHORUS, fx_chorus},
200 {26, EMUX_FX_REVERB, fx_reverb},
201 };
202
203
204 /*
205 * GS(SC88) NRPN effects; still experimental
206 */
207
208 /* cutoff: quarter semitone step, max=255 */
209 static int gs_cutoff(int val)
210 {
211 return (val - 64) * gs_sense[FX_CUTOFF] / 50;
212 }
213
214 /* resonance: 0 to 15(max) */
215 static int gs_filterQ(int val)
216 {
217 return (val - 64) * gs_sense[FX_RESONANCE] / 50;
218 }
219
220 /* attack: */
221 static int gs_attack(int val)
222 {
223 return -(val - 64) * gs_sense[FX_ATTACK] / 50;
224 }
225
226 /* decay: */
227 static int gs_decay(int val)
228 {
229 return -(val - 64) * gs_sense[FX_RELEASE] / 50;
230 }
231
232 /* release: */
233 static int gs_release(int val)
234 {
235 return -(val - 64) * gs_sense[FX_RELEASE] / 50;
236 }
237
238 /* vibrato freq: 0.042Hz step, max=255 */
239 static int gs_vib_rate(int val)
240 {
241 return (val - 64) * gs_sense[FX_VIBRATE] / 50;
242 }
243
244 /* vibrato depth: max=127, 1 octave */
245 static int gs_vib_depth(int val)
246 {
247 return (val - 64) * gs_sense[FX_VIBDEPTH] / 50;
248 }
249
250 /* vibrato delay: -0.725msec step */
251 static int gs_vib_delay(int val)
252 {
253 return -(val - 64) * gs_sense[FX_VIBDELAY] / 50;
254 }
255
256 static const struct nrpn_conv_table gs_effects[] =
257 {
258 {32, EMUX_FX_CUTOFF, gs_cutoff},
259 {33, EMUX_FX_FILTERQ, gs_filterQ},
260 {99, EMUX_FX_ENV2_ATTACK, gs_attack},
261 {100, EMUX_FX_ENV2_DECAY, gs_decay},
262 {102, EMUX_FX_ENV2_RELEASE, gs_release},
263 {8, EMUX_FX_LFO1_FREQ, gs_vib_rate},
264 {9, EMUX_FX_LFO1_VOLUME, gs_vib_depth},
265 {10, EMUX_FX_LFO1_DELAY, gs_vib_delay},
266 };
267
268
269 /*
270 * NRPN events
271 */
272 void
273 snd_emux_nrpn(void *p, struct snd_midi_channel *chan,
274 struct snd_midi_channel_set *chset)
275 {
276 struct snd_emux_port *port;
277
278 port = p;
279 if (snd_BUG_ON(!port || !chan))
280 return;
281
282 if (chan->control[MIDI_CTL_NONREG_PARM_NUM_MSB] == 127 &&
283 chan->control[MIDI_CTL_NONREG_PARM_NUM_LSB] <= 26) {
284 int val;
285 /* Win/DOS AWE32 specific NRPNs */
286 /* both MSB/LSB necessary */
287 val = (chan->control[MIDI_CTL_MSB_DATA_ENTRY] << 7) |
288 chan->control[MIDI_CTL_LSB_DATA_ENTRY];
289 val -= 8192;
290 send_converted_effect
291 (awe_effects, ARRAY_SIZE(awe_effects),
292 port, chan, chan->control[MIDI_CTL_NONREG_PARM_NUM_LSB],
293 val, EMUX_FX_FLAG_SET);
294 return;
295 }
296
297 if (port->chset.midi_mode == SNDRV_MIDI_MODE_GS &&
298 chan->control[MIDI_CTL_NONREG_PARM_NUM_MSB] == 1) {
299 int val;
300 /* GS specific NRPNs */
301 /* only MSB is valid */
302 val = chan->control[MIDI_CTL_MSB_DATA_ENTRY];
303 send_converted_effect
304 (gs_effects, ARRAY_SIZE(gs_effects),
305 port, chan, chan->control[MIDI_CTL_NONREG_PARM_NUM_LSB],
306 val, EMUX_FX_FLAG_ADD);
307 return;
308 }
309 }
310
311
312 /*
313 * XG control effects; still experimental
314 */
315
316 /* cutoff: quarter semitone step, max=255 */
317 static int xg_cutoff(int val)
318 {
319 return (val - 64) * xg_sense[FX_CUTOFF] / 64;
320 }
321
322 /* resonance: 0(open) to 15(most nasal) */
323 static int xg_filterQ(int val)
324 {
325 return (val - 64) * xg_sense[FX_RESONANCE] / 64;
326 }
327
328 /* attack: */
329 static int xg_attack(int val)
330 {
331 return -(val - 64) * xg_sense[FX_ATTACK] / 64;
332 }
333
334 /* release: */
335 static int xg_release(int val)
336 {
337 return -(val - 64) * xg_sense[FX_RELEASE] / 64;
338 }
339
340 static const struct nrpn_conv_table xg_effects[] =
341 {
342 {71, EMUX_FX_CUTOFF, xg_cutoff},
343 {74, EMUX_FX_FILTERQ, xg_filterQ},
344 {72, EMUX_FX_ENV2_RELEASE, xg_release},
345 {73, EMUX_FX_ENV2_ATTACK, xg_attack},
346 };
347
348 int
349 snd_emux_xg_control(struct snd_emux_port *port, struct snd_midi_channel *chan,
350 int param)
351 {
352 if (param >= ARRAY_SIZE(chan->control))
353 return -EINVAL;
354
355 return send_converted_effect(xg_effects, ARRAY_SIZE(xg_effects),
356 port, chan, param,
357 chan->control[param],
358 EMUX_FX_FLAG_ADD);
359 }
360
361 /*
362 * receive sysex
363 */
364 void
365 snd_emux_sysex(void *p, unsigned char *buf, int len, int parsed,
366 struct snd_midi_channel_set *chset)
367 {
368 struct snd_emux_port *port;
369 struct snd_emux *emu;
370
371 port = p;
372 if (snd_BUG_ON(!port || !chset))
373 return;
374 emu = port->emu;
375
376 switch (parsed) {
377 case SNDRV_MIDI_SYSEX_GS_MASTER_VOLUME:
378 snd_emux_update_port(port, SNDRV_EMUX_UPDATE_VOLUME);
379 break;
380 default:
381 if (emu->ops.sysex)
382 emu->ops.sysex(emu, buf, len, parsed, chset);
383 break;
384 }
385 }
386
387
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.