1 /* SPDX-License-Identifier: GPL-2.0 */
4 * linux/sound/oss/dmasound/dmasound.h
7 * Minor numbers for the sound driver.
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.
16 #include <linux/types.h>
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
32 /* switch on various prinks */
33 #define DEBUG_DMASOUND 1
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
41 #define MAX_CATCH_RADIUS 10
43 #define le2be16(x) (((x)<<8 & 0xff00) | ((x)>>8 & 0x00ff))
44 #define le2be16dbl(x) (((x)<<8 & 0xff00ff00) | ((x)>>8 & 0x00ff00ff))
46 #define IOCTL_IN(arg, ret) \
47 do { int error = get_user(ret, (int __user *)(arg)); \
48 if (error) return error; \
50 #define IOCTL_OUT(arg, ret) ioctl_return((int __user *)(arg), ret)
52 static inline int ioctl_return(int __user
*addr
, int value
)
54 return value
< 0 ? value
: put_user(value
, addr
);
62 #undef HAS_8BIT_TABLES
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
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) */
74 #else /* is pmac and multi is off */
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 */
83 #define DEFAULT_N_BUFFERS 4
84 #define DEFAULT_BUFF_SIZE (1<<15)
90 extern int dmasound_init(void);
92 extern void dmasound_deinit(void);
94 #define dmasound_deinit() do { } while (0)
97 /* description of the set-up applies to either hard or soft settings */
100 int format
; /* AFMT_* */
101 int stereo
; /* 0 = mono, 1 = stereo */
102 int size
; /* 8/16 bit*/
103 int speed
; /* speed */
107 * Machine definitions
113 struct module
*owner
;
114 void *(*dma_alloc
)(unsigned int, gfp_t
);
115 void (*dma_free
)(void *, unsigned int);
116 int (*irqinit
)(void);
118 void (*irqcleanup
)(void);
121 void (*silence
)(void);
122 int (*setFormat
)(int);
123 int (*setVolume
)(int);
125 int (*setTreble
)(int);
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 */
133 int (*sq_open
)(fmode_t
); /* optional */
134 int (*state_info
)(char *, size_t); /* optional */
135 void (*abort_read
)(void); /* optional */
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 */
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
);
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 */
167 int volume_left
; /* volume (range is machine dependent) */
169 int bass
; /* tone (range is machine dependent) */
172 int minDev
; /* minor device number currently open */
176 extern struct sound_settings dmasound
;
178 #ifdef HAS_8BIT_TABLES
179 extern char dmasound_ulaw2dma8
[];
180 extern char dmasound_alaw2dma8
[];
187 static inline int dmasound_set_volume(int volume
)
189 return dmasound
.mach
.setVolume(volume
);
192 static inline int dmasound_set_bass(int bass
)
194 return dmasound
.mach
.setBass
? dmasound
.mach
.setBass(bass
) : 50;
197 static inline int dmasound_set_treble(int treble
)
199 return dmasound
.mach
.setTreble
? dmasound
.mach
.setTreble(treble
) : 50;
202 static inline int dmasound_set_gain(int gain
)
204 return dmasound
.mach
.setGain
? dmasound
.mach
.setGain(gain
) : 100;
209 * Sound queue stuff, the heart of the driver
213 /* buffers allocated for this queue */
214 int numBufs
; /* real limits on what the user can have */
215 int bufSize
; /* in bytes */
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 */
226 /* it shouldn't be necessary to declare any of these volatile */
227 int front
, rear
, count
;
230 * The use of the playing field depends on the hardware
232 * Atari, PMac: The number of frames that are loaded/playing
234 * Amiga: Bit 0 is set: a frame is loaded
235 * Bit 1 is set: a frame is playing
238 wait_queue_head_t action_queue
, open_queue
, sync_queue
;
240 int busy
, syncing
, xruns
, died
;
243 #define WAKE_UP(queue) (wake_up_interruptible(&queue))
245 extern struct sound_queue dmasound_write_sq
;
246 #define write_sq dmasound_write_sq
248 extern int dmasound_catchRadius
;
249 #define catchRadius dmasound_catchRadius
251 /* define the value to be put in the byte-swap reg in mac-io
252 when we want it to swap for us.
256 #define SW_INPUT_VOLUME_SCALE 4
257 #define SW_INPUT_VOLUME_DEFAULT (128 / SW_INPUT_VOLUME_SCALE)
259 extern int expand_read_bal
; /* Balance factor for reading */
260 extern uint software_input_volume
; /* software implemented recording volume! */
262 #endif /* _dmasound_h_ */