1 /*
2  **********************************************************************
3  *     cardwo.h -- header file for card wave out functions
4  *     Copyright 1999, 2000 Creative Labs, Inc.
5  *
6  **********************************************************************
7  *
8  *     Date                 Author          Summary of changes
9  *     ----                 ------          ------------------
10  *     October 20, 1999     Bertrand Lee    base code release
11  *
12  **********************************************************************
13  *
14  *     This program is free software; you can redistribute it and/or
15  *     modify it under the terms of the GNU General Public License as
16  *     published by the Free Software Foundation; either version 2 of
17  *     the License, or (at your option) any later version.
18  *
19  *     This program is distributed in the hope that it will be useful,
20  *     but WITHOUT ANY WARRANTY; without even the implied warranty of
21  *     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22  *     GNU General Public License for more details.
23  *
24  *     You should have received a copy of the GNU General Public
25  *     License along with this program; if not, write to the Free
26  *     Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
27  *     USA.
28  *
29  **********************************************************************
30  */
31 
32 #ifndef _CARDWO_H
33 #define _CARDWO_H
34 
35 #include "icardwav.h"
36 #include "audio.h"
37 #include "voicemgr.h"
38 #include "timer.h"
39 
40 /* setting this to other than a power of two may break some applications */
41 #define WAVEOUT_MAXBUFSIZE	MAXBUFSIZE
42 
43 #define WAVEOUT_DEFAULTFRAGLEN	20 /* Time to play a fragment in ms (latency) */
44 #define WAVEOUT_DEFAULTBUFLEN	500 /* Time to play the entire buffer in ms */
45 
46 #define WAVEOUT_MINFRAGSHIFT	6 /* Minimum fragment size in bytes is 2^6 */
47 #define WAVEOUT_MINFRAGS	3 /* _don't_ go bellow 3, it would break silence filling */
48 #define WAVEOUT_MAXVOICES	6
49 
50 struct waveout_buffer {
51 	u16 ossfragshift;
52 	u32 numfrags;
53 	u32 fragment_size;	/* in bytes units */
54 	u32 size;		/* in bytes units */
55 	u32 pages;		/* buffer size in page units*/
56 	u32 silence_pos;	/* software cursor position (including silence bytes) */
57 	u32 hw_pos;		/* hardware cursor position */
58 	u32 free_bytes;		/* free bytes available on the buffer (not including silence bytes) */
59 	u8 fill_silence;
60 	u32 silence_bytes;      /* silence bytes on the buffer */
61 };
62 
63 struct woinst
64 {
65 	u8 state;
66 	u8 num_voices;
67 	struct emu_voice voice[WAVEOUT_MAXVOICES];
68 	struct emu_timer timer;
69 	struct wave_format format;
70 	struct waveout_buffer buffer;
71 	wait_queue_head_t wait_queue;
72 	u8 mmapped;
73 	u32 total_copied;	/* total number of bytes written() to the buffer (excluding silence) */
74 	u32 total_played;	/* total number of bytes played including silence */
75 	u32 blocks;
76 	u8 device;
77 	spinlock_t lock;
78 };
79 
80 int emu10k1_waveout_open(struct emu10k1_wavedevice *);
81 void emu10k1_waveout_close(struct emu10k1_wavedevice *);
82 void emu10k1_waveout_start(struct emu10k1_wavedevice *);
83 void emu10k1_waveout_stop(struct emu10k1_wavedevice *);
84 void emu10k1_waveout_getxfersize(struct woinst*, u32 *);
85 void emu10k1_waveout_xferdata(struct woinst*, u8*, u32 *);
86 void emu10k1_waveout_fillsilence(struct woinst*);
87 int emu10k1_waveout_setformat(struct emu10k1_wavedevice*, struct wave_format*);
88 void emu10k1_waveout_update(struct woinst*);
89 
90 #endif /* _CARDWO_H */
91