1 #ifndef _dmasound_h_
2 /*
3 * linux/drivers/sound/dmasound/dmasound.h
4 *
5 *
6 * Minor numbers for the sound driver.
7 *
8 * Unfortunately Creative called the codec chip of SB as a DSP. For this
9 * reason the /dev/dsp is reserved for digitized audio use. There is a
10 * device for true DSP processors but it will be called something else.
11 * In v3.0 it's /dev/sndproc but this could be a temporary solution.
12 */
13 #define _dmasound_h_
14
15 #include <linux/types.h>
16 #include <linux/config.h>
17
18 #define SND_NDEVS 256 /* Number of supported devices */
19 #define SND_DEV_CTL 0 /* Control port /dev/mixer */
20 #define SND_DEV_SEQ 1 /* Sequencer output /dev/sequencer (FM
21 synthesizer and MIDI output) */
22 #define SND_DEV_MIDIN 2 /* Raw midi access */
23 #define SND_DEV_DSP 3 /* Digitized voice /dev/dsp */
24 #define SND_DEV_AUDIO 4 /* Sparc compatible /dev/audio */
25 #define SND_DEV_DSP16 5 /* Like /dev/dsp but 16 bits/sample */
26 #define SND_DEV_STATUS 6 /* /dev/sndstat */
27 /* #7 not in use now. Was in 2.4. Free for use after v3.0. */
28 #define SND_DEV_SEQ2 8 /* /dev/sequencer, level 2 interface */
29 #define SND_DEV_SNDPROC 9 /* /dev/sndproc for programmable devices */
30 #define SND_DEV_PSS SND_DEV_SNDPROC
31
32 /* switch on various prinks */
33 #define DEBUG_DMASOUND 1
34
35 #define MAX_AUDIO_DEV 5
36 #define MAX_MIXER_DEV 4
37 #define MAX_SYNTH_DEV 3
38 #define MAX_MIDI_DEV 6
39 #define MAX_TIMER_DEV 3
40
41 #define MAX_CATCH_RADIUS 10
42
43 #define le2be16(x) (((x)<<8 & 0xff00) | ((x)>>8 & 0x00ff))
44 #define le2be16dbl(x) (((x)<<8 & 0xff00ff00) | ((x)>>8 & 0x00ff00ff))
45
46 #define IOCTL_IN(arg, ret) \
47 do { int error = get_user(ret, (int *)(arg)); \
48 if (error) return error; \
49 } while (0)
50 #define IOCTL_OUT(arg, ret) ioctl_return((int *)(arg), ret)
51
ioctl_return(int * addr,int value)52 static inline int ioctl_return(int *addr, int value)
53 {
54 return value < 0 ? value : put_user(value, addr);
55 }
56
57
58 /*
59 * Configuration
60 */
61
62 #undef HAS_8BIT_TABLES
63 #undef HAS_RECORD
64
65 #if defined(CONFIG_DMASOUND_ATARI) || defined(CONFIG_DMASOUND_ATARI_MODULE) ||\
66 defined(CONFIG_DMASOUND_PAULA) || defined(CONFIG_DMASOUND_PAULA_MODULE) ||\
67 defined(CONFIG_DMASOUND_Q40) || defined(CONFIG_DMASOUND_Q40_MODULE)
68 #define HAS_8BIT_TABLES
69 #define MIN_BUFFERS 4
70 #define MIN_BUFSIZE (1<<12) /* in bytes (- where does this come from ?) */
71 #define MIN_FRAG_SIZE 8 /* not 100% sure about this */
72 #define MAX_BUFSIZE (1<<17) /* Limit for Amiga is 128 kb */
73 #define MAX_FRAG_SIZE 15 /* allow *4 for mono-8 => stereo-16 (for multi) */
74
75 #else /* is pmac and multi is off */
76
77 #define MIN_BUFFERS 2
78 #define MIN_BUFSIZE (1<<8) /* in bytes */
79 #define MIN_FRAG_SIZE 8
80 #define MAX_BUFSIZE (1<<18) /* this is somewhat arbitrary for pmac */
81 #define MAX_FRAG_SIZE 16 /* need to allow *4 for mono-8 => stereo-16 */
82 #endif
83
84 #define DEFAULT_N_BUFFERS 4
85 #define DEFAULT_BUFF_SIZE (1<<15)
86
87 #if defined(CONFIG_DMASOUND_PMAC) || defined(CONFIG_DMASOUND_PMAC_MODULE)
88 #define HAS_RECORD
89 #endif
90
91 /*
92 * Initialization
93 */
94
95 extern int dmasound_init(void);
96 #ifdef MODULE
97 extern void dmasound_deinit(void);
98 #else
99 #define dmasound_deinit() do { } while (0)
100 #endif
101
102 /* description of the set-up applies to either hard or soft settings */
103
104 typedef struct {
105 int format; /* AFMT_* */
106 int stereo; /* 0 = mono, 1 = stereo */
107 int size; /* 8/16 bit*/
108 int speed; /* speed */
109 } SETTINGS;
110
111 /*
112 * Machine definitions
113 */
114
115 typedef struct {
116 const char *name;
117 const char *name2;
118 void (*open)(void);
119 void (*release)(void);
120 void *(*dma_alloc)(unsigned int, int);
121 void (*dma_free)(void *, unsigned int);
122 int (*irqinit)(void);
123 #ifdef MODULE
124 void (*irqcleanup)(void);
125 #endif
126 void (*init)(void);
127 void (*silence)(void);
128 int (*setFormat)(int);
129 int (*setVolume)(int);
130 int (*setBass)(int);
131 int (*setTreble)(int);
132 int (*setGain)(int);
133 void (*play)(void);
134 void (*record)(void); /* optional */
135 void (*mixer_init)(void); /* optional */
136 int (*mixer_ioctl)(u_int, u_long); /* optional */
137 int (*write_sq_setup)(void); /* optional */
138 int (*read_sq_setup)(void); /* optional */
139 int (*sq_open)(mode_t); /* optional */
140 int (*state_info)(char *, size_t); /* optional */
141 void (*abort_read)(void); /* optional */
142 int min_dsp_speed;
143 int max_dsp_speed;
144 int version ;
145 int hardware_afmts ; /* OSS says we only return h'ware info */
146 /* when queried via SNDCTL_DSP_GETFMTS */
147 int capabilities ; /* low-level reply to SNDCTL_DSP_GETCAPS */
148 SETTINGS default_hard ; /* open() or init() should set something valid */
149 SETTINGS default_soft ; /* you can make it look like old OSS, if you want to */
150 } MACHINE;
151
152 /*
153 * Low level stuff
154 */
155
156 typedef struct {
157 ssize_t (*ct_ulaw)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
158 ssize_t (*ct_alaw)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
159 ssize_t (*ct_s8)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
160 ssize_t (*ct_u8)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
161 ssize_t (*ct_s16be)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
162 ssize_t (*ct_u16be)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
163 ssize_t (*ct_s16le)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
164 ssize_t (*ct_u16le)(const u_char *, size_t, u_char *, ssize_t *, ssize_t);
165 } TRANS;
166
167 struct sound_settings {
168 MACHINE mach; /* machine dependent things */
169 SETTINGS hard; /* hardware settings */
170 SETTINGS soft; /* software settings */
171 SETTINGS dsp; /* /dev/dsp default settings */
172 TRANS *trans_write; /* supported translations */
173 #ifdef HAS_RECORD
174 TRANS *trans_read; /* supported translations */
175 #endif
176 int volume_left; /* volume (range is machine dependent) */
177 int volume_right;
178 int bass; /* tone (range is machine dependent) */
179 int treble;
180 int gain;
181 int minDev; /* minor device number currently open */
182 };
183
184 extern struct sound_settings dmasound;
185
186 #ifdef HAS_8BIT_TABLES
187 extern char dmasound_ulaw2dma8[];
188 extern char dmasound_alaw2dma8[];
189 #endif
190
191 /*
192 * Mid level stuff
193 */
194
dmasound_set_volume(int volume)195 static inline int dmasound_set_volume(int volume)
196 {
197 return dmasound.mach.setVolume(volume);
198 }
199
dmasound_set_bass(int bass)200 static inline int dmasound_set_bass(int bass)
201 {
202 return dmasound.mach.setBass ? dmasound.mach.setBass(bass) : 50;
203 }
204
dmasound_set_treble(int treble)205 static inline int dmasound_set_treble(int treble)
206 {
207 return dmasound.mach.setTreble ? dmasound.mach.setTreble(treble) : 50;
208 }
209
dmasound_set_gain(int gain)210 static inline int dmasound_set_gain(int gain)
211 {
212 return dmasound.mach.setGain ? dmasound.mach.setGain(gain) : 100;
213 }
214
215
216 /*
217 * Sound queue stuff, the heart of the driver
218 */
219
220 struct sound_queue {
221 /* buffers allocated for this queue */
222 int numBufs; /* real limits on what the user can have */
223 int bufSize; /* in bytes */
224 char **buffers;
225
226 /* current parameters */
227 int locked ; /* params cannot be modified when != 0 */
228 int user_frags ; /* user requests this many */
229 int user_frag_size ; /* of this size */
230 int max_count; /* actual # fragments <= numBufs */
231 int block_size; /* internal block size in bytes */
232 int max_active; /* in-use fragments <= max_count */
233
234 /* it shouldn't be necessary to declare any of these volatile */
235 int front, rear, count;
236 int rear_size;
237 /*
238 * The use of the playing field depends on the hardware
239 *
240 * Atari, PMac: The number of frames that are loaded/playing
241 *
242 * Amiga: Bit 0 is set: a frame is loaded
243 * Bit 1 is set: a frame is playing
244 */
245 int active;
246 wait_queue_head_t action_queue, open_queue, sync_queue;
247 int open_mode;
248 int busy, syncing, xruns, died;
249 };
250
251 #define SLEEP(queue) interruptible_sleep_on_timeout(&queue, HZ)
252 #define WAKE_UP(queue) (wake_up_interruptible(&queue))
253
254 extern struct sound_queue dmasound_write_sq;
255 #define write_sq dmasound_write_sq
256
257 #ifdef HAS_RECORD
258 extern struct sound_queue dmasound_read_sq;
259 #define read_sq dmasound_read_sq
260 #endif
261
262 extern int dmasound_catchRadius;
263 #define catchRadius dmasound_catchRadius
264
265 /* define the value to be put in the byte-swap reg in mac-io
266 when we want it to swap for us.
267 */
268 #define BS_VAL 1
269
wait_ms(unsigned int ms)270 static inline void wait_ms(unsigned int ms)
271 {
272 current->state = TASK_UNINTERRUPTIBLE;
273 schedule_timeout(1 + ms * HZ / 1000);
274 }
275
276 #endif /* _dmasound_h_ */
277