Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
emux_synth.h
Go to the documentation of this file.
1 #ifndef __SOUND_EMUX_SYNTH_H
2 #define __SOUND_EMUX_SYNTH_H
3 
4 /*
5  * Defines for the Emu-series WaveTable chip
6  *
7  * Copyright (C) 2000 Takashi Iwai <[email protected]>
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 #include <sound/seq_kernel.h>
25 #include <sound/seq_device.h>
26 #include <sound/soundfont.h>
27 #include <sound/seq_midi_emul.h>
28 #ifdef CONFIG_SND_SEQUENCER_OSS
29 #include <sound/seq_oss.h>
30 #endif
31 #include <sound/emux_legacy.h>
32 #include <sound/seq_virmidi.h>
33 
34 /*
35  * compile flags
36  */
37 #define SNDRV_EMUX_USE_RAW_EFFECT
38 
39 struct snd_emux;
40 struct snd_emux_port;
41 struct snd_emux_voice;
43 
44 /*
45  * operators
46  */
48  struct module *owner;
49  struct snd_emux_voice *(*get_voice)(struct snd_emux *emu,
50  struct snd_emux_port *port);
51  int (*prepare)(struct snd_emux_voice *vp);
52  void (*trigger)(struct snd_emux_voice *vp);
53  void (*release)(struct snd_emux_voice *vp);
54  void (*update)(struct snd_emux_voice *vp, int update);
55  void (*terminate)(struct snd_emux_voice *vp);
56  void (*free_voice)(struct snd_emux_voice *vp);
57  void (*reset)(struct snd_emux *emu, int ch);
58  /* the first parameters are struct snd_emux */
59  int (*sample_new)(struct snd_emux *emu, struct snd_sf_sample *sp,
60  struct snd_util_memhdr *hdr,
61  const void __user *data, long count);
62  int (*sample_free)(struct snd_emux *emu, struct snd_sf_sample *sp,
63  struct snd_util_memhdr *hdr);
65  int (*load_fx)(struct snd_emux *emu, int type, int arg,
66  const void __user *data, long count);
67  void (*sysex)(struct snd_emux *emu, char *buf, int len, int parsed,
68  struct snd_midi_channel_set *chset);
69 #ifdef CONFIG_SND_SEQUENCER_OSS
70  int (*oss_ioctl)(struct snd_emux *emu, int cmd, int p1, int p2);
71 #endif
72 };
73 
74 
75 /*
76  * constant values
77  */
78 #define SNDRV_EMUX_MAX_PORTS 32 /* max # of sequencer ports */
79 #define SNDRV_EMUX_MAX_VOICES 64 /* max # of voices */
80 #define SNDRV_EMUX_MAX_MULTI_VOICES 16 /* max # of playable voices
81  * simultineously
82  */
83 
84 /*
85  * flags
86  */
87 #define SNDRV_EMUX_ACCEPT_ROM (1<<0)
88 
89 /*
90  * emuX wavetable
91  */
92 struct snd_emux {
93 
94  struct snd_card *card; /* assigned card */
95 
96  /* following should be initialized before registration */
97  int max_voices; /* Number of voices */
98  int mem_size; /* memory size (in byte) */
99  int num_ports; /* number of ports to be created */
100  int pitch_shift; /* pitch shift value (for Emu10k1) */
101  struct snd_emux_operators ops; /* operators */
102  void *hw; /* hardware */
103  unsigned long flags; /* other conditions */
104  int midi_ports; /* number of virtual midi devices */
105  int midi_devidx; /* device offset of virtual midi */
106  unsigned int linear_panning: 1; /* panning is linear (sbawe = 1, emu10k1 = 0) */
107  int hwdep_idx; /* hwdep device index */
108  struct snd_hwdep *hwdep; /* hwdep device */
110  /* private */
111  int num_voices; /* current number of voices */
112  struct snd_sf_list *sflist; /* root of SoundFont list */
113  struct snd_emux_voice *voices; /* Voices (EMU 'channel') */
114  int use_time; /* allocation counter */
115  spinlock_t voice_lock; /* Lock for voice access */
117  int client; /* For the sequencer client */
118  int ports[SNDRV_EMUX_MAX_PORTS]; /* The ports for this device */
120  int used; /* use counter */
121  char *name; /* name of the device (internal) */
122  struct snd_rawmidi **vmidi;
123  struct timer_list tlist; /* for pending note-offs */
125 
126  struct snd_util_memhdr *memhdr; /* memory chunk information */
127 
128 #ifdef CONFIG_PROC_FS
129  struct snd_info_entry *proc;
130 #endif
131 
132 #ifdef CONFIG_SND_SEQUENCER_OSS
133  struct snd_seq_device *oss_synth;
134 #endif
135 };
136 
137 
138 /*
139  * sequencer port information
140  */
144  struct snd_emux *emu;
146  char port_mode; /* operation mode */
147  int volume_atten; /* emuX raw attenuation */
148  unsigned long drum_flags; /* drum bitmaps */
149  int ctrls[EMUX_MD_END]; /* control parameters */
150 #ifdef SNDRV_EMUX_USE_RAW_EFFECT
152 #endif
153 #ifdef CONFIG_SND_SEQUENCER_OSS
154  struct snd_seq_oss_arg *oss_arg;
155 #endif
156 };
158 /* port_mode */
159 #define SNDRV_EMUX_PORT_MODE_MIDI 0 /* normal MIDI port */
160 #define SNDRV_EMUX_PORT_MODE_OSS_SYNTH 1 /* OSS synth port */
161 #define SNDRV_EMUX_PORT_MODE_OSS_MIDI 2 /* OSS multi channel synth port */
162 
163 /*
164  * A structure to keep track of each hardware voice
165  */
166 struct snd_emux_voice {
167  int ch; /* Hardware channel number */
169  int state; /* status */
170 #define SNDRV_EMUX_ST_OFF 0x00 /* Not playing, and inactive */
171 #define SNDRV_EMUX_ST_ON 0x01 /* Note on */
172 #define SNDRV_EMUX_ST_RELEASED (0x02|SNDRV_EMUX_ST_ON) /* Note released */
173 #define SNDRV_EMUX_ST_SUSTAINED (0x04|SNDRV_EMUX_ST_ON) /* Note sustained */
174 #define SNDRV_EMUX_ST_STANDBY (0x08|SNDRV_EMUX_ST_ON) /* Waiting to be triggered */
175 #define SNDRV_EMUX_ST_PENDING (0x10|SNDRV_EMUX_ST_ON) /* Note will be released */
176 #define SNDRV_EMUX_ST_LOCKED 0x100 /* Not accessible */
178  unsigned int time; /* An allocation time */
179  unsigned char note; /* Note currently assigned to this voice */
180  unsigned char key;
181  unsigned char velocity; /* Velocity of current note */
183  struct snd_sf_zone *zone; /* Zone assigned to this note */
184  void *block; /* sample block pointer (optional) */
185  struct snd_midi_channel *chan; /* Midi channel for this note */
186  struct snd_emux_port *port; /* associated port */
187  struct snd_emux *emu; /* assigned root info */
188  void *hw; /* hardware pointer (emu8000 or emu10k1) */
189  unsigned long ontime; /* jiffies at note triggered */
190 
191  /* Emu8k/Emu10k1 registers */
192  struct soundfont_voice_info reg;
194  /* additional registers */
195  int avol; /* volume attenuation */
196  int acutoff; /* cutoff target */
197  int apitch; /* pitch offset */
198  int apan; /* pan/aux pair */
199  int aaux;
200  int ptarget; /* pitch target */
201  int vtarget; /* volume target */
202  int ftarget; /* filter target */
203 
204 };
205 
206 /*
207  * update flags (can be combined)
208  */
209 #define SNDRV_EMUX_UPDATE_VOLUME (1<<0)
210 #define SNDRV_EMUX_UPDATE_PITCH (1<<1)
211 #define SNDRV_EMUX_UPDATE_PAN (1<<2)
212 #define SNDRV_EMUX_UPDATE_FMMOD (1<<3)
213 #define SNDRV_EMUX_UPDATE_TREMFREQ (1<<4)
214 #define SNDRV_EMUX_UPDATE_FM2FRQ2 (1<<5)
215 #define SNDRV_EMUX_UPDATE_Q (1<<6)
216 
217 
218 #ifdef SNDRV_EMUX_USE_RAW_EFFECT
219 /*
220  * effect table
221  */
223  /* Emu8000 specific effects */
224  short val[EMUX_NUM_EFFECTS];
225  unsigned char flag[EMUX_NUM_EFFECTS];
226 };
227 #endif /* SNDRV_EMUX_USE_RAW_EFFECT */
228 
229 
230 /*
231  * prototypes - interface to Emu10k1 and Emu8k routines
232  */
233 int snd_emux_new(struct snd_emux **remu);
234 int snd_emux_register(struct snd_emux *emu, struct snd_card *card, int index, char *name);
235 int snd_emux_free(struct snd_emux *emu);
236 
237 /*
238  * exported functions
239  */
240 void snd_emux_terminate_all(struct snd_emux *emu);
241 void snd_emux_lock_voice(struct snd_emux *emu, int voice);
242 void snd_emux_unlock_voice(struct snd_emux *emu, int voice);
243 
244 #endif /* __SOUND_EMUX_SYNTH_H */