]>
Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | #ifndef _dmasound_h_ |
3 | /* | |
4 | * linux/sound/oss/dmasound/dmasound.h | |
5 | * | |
6 | * | |
7 | * Minor numbers for the sound driver. | |
8 | * | |
9 | * Unfortunately Creative called the codec chip of SB as a DSP. For this | |
10 | * reason the /dev/dsp is reserved for digitized audio use. There is a | |
11 | * device for true DSP processors but it will be called something else. | |
12 | * In v3.0 it's /dev/sndproc but this could be a temporary solution. | |
13 | */ | |
14 | #define _dmasound_h_ | |
15 | ||
16 | #include <linux/types.h> | |
1da177e4 LT |
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 __user *)(arg)); \ | |
48 | if (error) return error; \ | |
49 | } while (0) | |
50 | #define IOCTL_OUT(arg, ret) ioctl_return((int __user *)(arg), ret) | |
51 | ||
52 | static inline int ioctl_return(int __user *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 | |
1da177e4 LT |
63 | |
64 | #if defined(CONFIG_DMASOUND_ATARI) || defined(CONFIG_DMASOUND_ATARI_MODULE) ||\ | |
65 | defined(CONFIG_DMASOUND_PAULA) || defined(CONFIG_DMASOUND_PAULA_MODULE) ||\ | |
66 | defined(CONFIG_DMASOUND_Q40) || defined(CONFIG_DMASOUND_Q40_MODULE) | |
67 | #define HAS_8BIT_TABLES | |
68 | #define MIN_BUFFERS 4 | |
69 | #define MIN_BUFSIZE (1<<12) /* in bytes (- where does this come from ?) */ | |
70 | #define MIN_FRAG_SIZE 8 /* not 100% sure about this */ | |
71 | #define MAX_BUFSIZE (1<<17) /* Limit for Amiga is 128 kb */ | |
72 | #define MAX_FRAG_SIZE 15 /* allow *4 for mono-8 => stereo-16 (for multi) */ | |
73 | ||
74 | #else /* is pmac and multi is off */ | |
75 | ||
76 | #define MIN_BUFFERS 2 | |
77 | #define MIN_BUFSIZE (1<<8) /* in bytes */ | |
78 | #define MIN_FRAG_SIZE 8 | |
79 | #define MAX_BUFSIZE (1<<18) /* this is somewhat arbitrary for pmac */ | |
80 | #define MAX_FRAG_SIZE 16 /* need to allow *4 for mono-8 => stereo-16 */ | |
81 | #endif | |
82 | ||
83 | #define DEFAULT_N_BUFFERS 4 | |
84 | #define DEFAULT_BUFF_SIZE (1<<15) | |
85 | ||
1da177e4 LT |
86 | /* |
87 | * Initialization | |
88 | */ | |
89 | ||
90 | extern int dmasound_init(void); | |
91 | #ifdef MODULE | |
92 | extern void dmasound_deinit(void); | |
93 | #else | |
94 | #define dmasound_deinit() do { } while (0) | |
95 | #endif | |
96 | ||
97 | /* description of the set-up applies to either hard or soft settings */ | |
98 | ||
99 | typedef struct { | |
100 | int format; /* AFMT_* */ | |
101 | int stereo; /* 0 = mono, 1 = stereo */ | |
102 | int size; /* 8/16 bit*/ | |
103 | int speed; /* speed */ | |
104 | } SETTINGS; | |
105 | ||
106 | /* | |
107 | * Machine definitions | |
108 | */ | |
109 | ||
110 | typedef struct { | |
111 | const char *name; | |
112 | const char *name2; | |
113 | struct module *owner; | |
1ef64e67 | 114 | void *(*dma_alloc)(unsigned int, gfp_t); |
1da177e4 LT |
115 | void (*dma_free)(void *, unsigned int); |
116 | int (*irqinit)(void); | |
117 | #ifdef MODULE | |
118 | void (*irqcleanup)(void); | |
119 | #endif | |
120 | void (*init)(void); | |
121 | void (*silence)(void); | |
122 | int (*setFormat)(int); | |
123 | int (*setVolume)(int); | |
124 | int (*setBass)(int); | |
125 | int (*setTreble)(int); | |
126 | int (*setGain)(int); | |
127 | void (*play)(void); | |
128 | void (*record)(void); /* optional */ | |
129 | void (*mixer_init)(void); /* optional */ | |
130 | int (*mixer_ioctl)(u_int, u_long); /* optional */ | |
131 | int (*write_sq_setup)(void); /* optional */ | |
132 | int (*read_sq_setup)(void); /* optional */ | |
aeb5d727 | 133 | int (*sq_open)(fmode_t); /* optional */ |
1da177e4 LT |
134 | int (*state_info)(char *, size_t); /* optional */ |
135 | void (*abort_read)(void); /* optional */ | |
136 | int min_dsp_speed; | |
137 | int max_dsp_speed; | |
138 | int version ; | |
139 | int hardware_afmts ; /* OSS says we only return h'ware info */ | |
140 | /* when queried via SNDCTL_DSP_GETFMTS */ | |
141 | int capabilities ; /* low-level reply to SNDCTL_DSP_GETCAPS */ | |
142 | SETTINGS default_hard ; /* open() or init() should set something valid */ | |
143 | SETTINGS default_soft ; /* you can make it look like old OSS, if you want to */ | |
144 | } MACHINE; | |
145 | ||
146 | /* | |
147 | * Low level stuff | |
148 | */ | |
149 | ||
150 | typedef struct { | |
151 | ssize_t (*ct_ulaw)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
152 | ssize_t (*ct_alaw)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
153 | ssize_t (*ct_s8)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
154 | ssize_t (*ct_u8)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
155 | ssize_t (*ct_s16be)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
156 | ssize_t (*ct_u16be)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
157 | ssize_t (*ct_s16le)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
158 | ssize_t (*ct_u16le)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t); | |
159 | } TRANS; | |
160 | ||
161 | struct sound_settings { | |
162 | MACHINE mach; /* machine dependent things */ | |
163 | SETTINGS hard; /* hardware settings */ | |
164 | SETTINGS soft; /* software settings */ | |
165 | SETTINGS dsp; /* /dev/dsp default settings */ | |
166 | TRANS *trans_write; /* supported translations */ | |
1da177e4 LT |
167 | int volume_left; /* volume (range is machine dependent) */ |
168 | int volume_right; | |
169 | int bass; /* tone (range is machine dependent) */ | |
170 | int treble; | |
171 | int gain; | |
172 | int minDev; /* minor device number currently open */ | |
173 | spinlock_t lock; | |
174 | }; | |
175 | ||
176 | extern struct sound_settings dmasound; | |
177 | ||
178 | #ifdef HAS_8BIT_TABLES | |
179 | extern char dmasound_ulaw2dma8[]; | |
180 | extern char dmasound_alaw2dma8[]; | |
181 | #endif | |
182 | ||
183 | /* | |
184 | * Mid level stuff | |
185 | */ | |
186 | ||
187 | static inline int dmasound_set_volume(int volume) | |
188 | { | |
189 | return dmasound.mach.setVolume(volume); | |
190 | } | |
191 | ||
192 | static inline int dmasound_set_bass(int bass) | |
193 | { | |
194 | return dmasound.mach.setBass ? dmasound.mach.setBass(bass) : 50; | |
195 | } | |
196 | ||
197 | static inline int dmasound_set_treble(int treble) | |
198 | { | |
199 | return dmasound.mach.setTreble ? dmasound.mach.setTreble(treble) : 50; | |
200 | } | |
201 | ||
202 | static inline int dmasound_set_gain(int gain) | |
203 | { | |
204 | return dmasound.mach.setGain ? dmasound.mach.setGain(gain) : 100; | |
205 | } | |
206 | ||
207 | ||
208 | /* | |
209 | * Sound queue stuff, the heart of the driver | |
210 | */ | |
211 | ||
212 | struct sound_queue { | |
213 | /* buffers allocated for this queue */ | |
214 | int numBufs; /* real limits on what the user can have */ | |
215 | int bufSize; /* in bytes */ | |
216 | char **buffers; | |
217 | ||
218 | /* current parameters */ | |
219 | int locked ; /* params cannot be modified when != 0 */ | |
220 | int user_frags ; /* user requests this many */ | |
221 | int user_frag_size ; /* of this size */ | |
222 | int max_count; /* actual # fragments <= numBufs */ | |
223 | int block_size; /* internal block size in bytes */ | |
224 | int max_active; /* in-use fragments <= max_count */ | |
225 | ||
226 | /* it shouldn't be necessary to declare any of these volatile */ | |
227 | int front, rear, count; | |
228 | int rear_size; | |
229 | /* | |
230 | * The use of the playing field depends on the hardware | |
231 | * | |
232 | * Atari, PMac: The number of frames that are loaded/playing | |
233 | * | |
234 | * Amiga: Bit 0 is set: a frame is loaded | |
235 | * Bit 1 is set: a frame is playing | |
236 | */ | |
237 | int active; | |
238 | wait_queue_head_t action_queue, open_queue, sync_queue; | |
4b30fbde | 239 | int non_blocking; |
1da177e4 LT |
240 | int busy, syncing, xruns, died; |
241 | }; | |
242 | ||
1da177e4 LT |
243 | #define WAKE_UP(queue) (wake_up_interruptible(&queue)) |
244 | ||
245 | extern struct sound_queue dmasound_write_sq; | |
246 | #define write_sq dmasound_write_sq | |
247 | ||
1da177e4 LT |
248 | extern int dmasound_catchRadius; |
249 | #define catchRadius dmasound_catchRadius | |
250 | ||
251 | /* define the value to be put in the byte-swap reg in mac-io | |
252 | when we want it to swap for us. | |
253 | */ | |
254 | #define BS_VAL 1 | |
255 | ||
256 | #define SW_INPUT_VOLUME_SCALE 4 | |
257 | #define SW_INPUT_VOLUME_DEFAULT (128 / SW_INPUT_VOLUME_SCALE) | |
258 | ||
1da177e4 LT |
259 | extern int expand_read_bal; /* Balance factor for reading */ |
260 | extern uint software_input_volume; /* software implemented recording volume! */ | |
261 | ||
262 | #endif /* _dmasound_h_ */ |