Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  1 #ifndef _dmasound_h_
  2 /*
  3  *  linux/sound/oss/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 __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
 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     struct module *owner;
119     void *(*dma_alloc)(unsigned int, int);
120     void (*dma_free)(void *, unsigned int);
121     int (*irqinit)(void);
122 #ifdef MODULE
123     void (*irqcleanup)(void);
124 #endif
125     void (*init)(void);
126     void (*silence)(void);
127     int (*setFormat)(int);
128     int (*setVolume)(int);
129     int (*setBass)(int);
130     int (*setTreble)(int);
131     int (*setGain)(int);
132     void (*play)(void);
133     void (*record)(void);               /* optional */
134     void (*mixer_init)(void);           /* optional */
135     int (*mixer_ioctl)(u_int, u_long);  /* optional */
136     int (*write_sq_setup)(void);        /* optional */
137     int (*read_sq_setup)(void);         /* optional */
138     int (*sq_open)(mode_t);             /* optional */
139     int (*state_info)(char *, size_t);  /* optional */
140     void (*abort_read)(void);           /* optional */
141     int min_dsp_speed;
142     int max_dsp_speed;
143     int version ;
144     int hardware_afmts ;                /* OSS says we only return h'ware info */
145                                         /* when queried via SNDCTL_DSP_GETFMTS */
146     int capabilities ;          /* low-level reply to SNDCTL_DSP_GETCAPS */
147     SETTINGS default_hard ;     /* open() or init() should set something valid */
148     SETTINGS default_soft ;     /* you can make it look like old OSS, if you want to */
149 } MACHINE;
150 
151     /*
152      *  Low level stuff
153      */
154 
155 typedef struct {
156     ssize_t (*ct_ulaw)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
157     ssize_t (*ct_alaw)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
158     ssize_t (*ct_s8)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
159     ssize_t (*ct_u8)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
160     ssize_t (*ct_s16be)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
161     ssize_t (*ct_u16be)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
162     ssize_t (*ct_s16le)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
163     ssize_t (*ct_u16le)(const u_char __user *, size_t, u_char *, ssize_t *, ssize_t);
164 } TRANS;
165 
166 struct sound_settings {
167     MACHINE mach;       /* machine dependent things */
168     SETTINGS hard;      /* hardware settings */
169     SETTINGS soft;      /* software settings */
170     SETTINGS dsp;       /* /dev/dsp default settings */
171     TRANS *trans_write; /* supported translations */
172 #ifdef HAS_RECORD
173     TRANS *trans_read;  /* supported translations */
174 #endif
175     int volume_left;    /* volume (range is machine dependent) */
176     int volume_right;
177     int bass;           /* tone (range is machine dependent) */
178     int treble;
179     int gain;
180     int minDev;         /* minor device number currently open */
181     spinlock_t lock;
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 
195 static inline int dmasound_set_volume(int volume)
196 {
197         return dmasound.mach.setVolume(volume);
198 }
199 
200 static inline int dmasound_set_bass(int bass)
201 {
202         return dmasound.mach.setBass ? dmasound.mach.setBass(bass) : 50;
203 }
204 
205 static inline int dmasound_set_treble(int treble)
206 {
207         return dmasound.mach.setTreble ? dmasound.mach.setTreble(treble) : 50;
208 }
209 
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 
270 #define SW_INPUT_VOLUME_SCALE   4
271 #define SW_INPUT_VOLUME_DEFAULT (128 / SW_INPUT_VOLUME_SCALE)
272 
273 extern int expand_bal;  /* Balance factor for expanding (not volume!) */
274 extern int expand_read_bal;     /* Balance factor for reading */
275 extern uint software_input_volume; /* software implemented recording volume! */
276 
277 #endif /* _dmasound_h_ */
278 
  This page was automatically generated by the LXR engine.