254 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2#ifndef _dmasound_h_3/*4 * linux/sound/oss/dmasound/dmasound.h5 *6 *7 * Minor numbers for the sound driver.8 *9 * Unfortunately Creative called the codec chip of SB as a DSP. For this10 * reason the /dev/dsp is reserved for digitized audio use. There is a11 * 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>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 (FM21 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_SNDPROC31 32/* switch on various prinks */33#define DEBUG_DMASOUND 134 35#define MAX_AUDIO_DEV 536#define MAX_MIXER_DEV 437#define MAX_SYNTH_DEV 338#define MAX_MIDI_DEV 639#define MAX_TIMER_DEV 340 41#define MAX_CATCH_RADIUS 1042 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 52static inline int ioctl_return(int __user *addr, int value)53{54 return value < 0 ? value : put_user(value, addr);55}56 57 58 /*59 * Configuration60 */61 62#undef HAS_8BIT_TABLES63 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_TABLES68#define MIN_BUFFERS 469#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 277#define MIN_BUFSIZE (1<<8) /* in bytes */78#define MIN_FRAG_SIZE 879#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#endif82 83#define DEFAULT_N_BUFFERS 484#define DEFAULT_BUFF_SIZE (1<<15)85 86 /*87 * Initialization88 */89 90extern int dmasound_init(void);91extern void dmasound_deinit(void);92 93/* description of the set-up applies to either hard or soft settings */94 95typedef struct {96 int format; /* AFMT_* */97 int stereo; /* 0 = mono, 1 = stereo */98 int size; /* 8/16 bit*/99 int speed; /* speed */100} SETTINGS;101 102 /*103 * Machine definitions104 */105 106typedef struct {107 const char *name;108 const char *name2;109 struct module *owner;110 void *(*dma_alloc)(unsigned int, gfp_t);111 void (*dma_free)(void *, unsigned int);112 int (*irqinit)(void);113 void (*irqcleanup)(void);114 void (*init)(void);115 void (*silence)(void);116 int (*setFormat)(int);117 int (*setVolume)(int);118 int (*setBass)(int);119 int (*setTreble)(int);120 int (*setGain)(int);121 void (*play)(void);122 void (*record)(void); /* optional */123 void (*mixer_init)(void); /* optional */124 int (*mixer_ioctl)(u_int, u_long); /* optional */125 int (*write_sq_setup)(void); /* optional */126 int (*read_sq_setup)(void); /* optional */127 int (*sq_open)(fmode_t); /* optional */128 int (*state_info)(char *, size_t); /* optional */129 void (*abort_read)(void); /* optional */130 int min_dsp_speed;131 int max_dsp_speed;132 int version ;133 int hardware_afmts ; /* OSS says we only return h'ware info */134 /* when queried via SNDCTL_DSP_GETFMTS */135 int capabilities ; /* low-level reply to SNDCTL_DSP_GETCAPS */136 SETTINGS default_hard ; /* open() or init() should set something valid */137 SETTINGS default_soft ; /* you can make it look like old OSS, if you want to */138} MACHINE;139 140 /*141 * Low level stuff142 */143 144typedef struct {145 ssize_t (*ct_ulaw)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);146 ssize_t (*ct_alaw)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);147 ssize_t (*ct_s8)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);148 ssize_t (*ct_u8)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);149 ssize_t (*ct_s16be)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);150 ssize_t (*ct_u16be)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);151 ssize_t (*ct_s16le)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);152 ssize_t (*ct_u16le)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);153} TRANS;154 155struct sound_settings {156 MACHINE mach; /* machine dependent things */157 SETTINGS hard; /* hardware settings */158 SETTINGS soft; /* software settings */159 SETTINGS dsp; /* /dev/dsp default settings */160 TRANS *trans_write; /* supported translations */161 int volume_left; /* volume (range is machine dependent) */162 int volume_right;163 int bass; /* tone (range is machine dependent) */164 int treble;165 int gain;166 int minDev; /* minor device number currently open */167 spinlock_t lock;168};169 170extern struct sound_settings dmasound;171 172#ifdef HAS_8BIT_TABLES173extern char dmasound_ulaw2dma8[];174extern char dmasound_alaw2dma8[];175#endif176 177 /*178 * Mid level stuff179 */180 181static inline int dmasound_set_volume(int volume)182{183 return dmasound.mach.setVolume(volume);184}185 186static inline int dmasound_set_bass(int bass)187{188 return dmasound.mach.setBass ? dmasound.mach.setBass(bass) : 50;189}190 191static inline int dmasound_set_treble(int treble)192{193 return dmasound.mach.setTreble ? dmasound.mach.setTreble(treble) : 50;194}195 196static inline int dmasound_set_gain(int gain)197{198 return dmasound.mach.setGain ? dmasound.mach.setGain(gain) : 100;199}200 201 202 /*203 * Sound queue stuff, the heart of the driver204 */205 206struct sound_queue {207 /* buffers allocated for this queue */208 int numBufs; /* real limits on what the user can have */209 int bufSize; /* in bytes */210 char **buffers;211 212 /* current parameters */213 int locked ; /* params cannot be modified when != 0 */214 int user_frags ; /* user requests this many */215 int user_frag_size ; /* of this size */216 int max_count; /* actual # fragments <= numBufs */217 int block_size; /* internal block size in bytes */218 int max_active; /* in-use fragments <= max_count */219 220 /* it shouldn't be necessary to declare any of these volatile */221 int front, rear, count;222 int rear_size;223 /*224 * The use of the playing field depends on the hardware225 *226 * Atari, PMac: The number of frames that are loaded/playing227 *228 * Amiga: Bit 0 is set: a frame is loaded229 * Bit 1 is set: a frame is playing230 */231 int active;232 wait_queue_head_t action_queue, open_queue, sync_queue;233 int non_blocking;234 int busy, syncing, xruns, died;235};236 237#define WAKE_UP(queue) (wake_up_interruptible(&queue))238 239extern struct sound_queue dmasound_write_sq;240#define write_sq dmasound_write_sq241 242extern int dmasound_catchRadius;243#define catchRadius dmasound_catchRadius244 245/* define the value to be put in the byte-swap reg in mac-io246 when we want it to swap for us.247*/248#define BS_VAL 1249 250#define SW_INPUT_VOLUME_SCALE 4251#define SW_INPUT_VOLUME_DEFAULT (128 / SW_INPUT_VOLUME_SCALE)252 253#endif /* _dmasound_h_ */254