channel.h revision 59020
1167465Smp/*
259243Sobrien * Copyright (c) 1999 Cameron Grant <gandalf@vilnya.demon.co.uk>
359243Sobrien * All rights reserved.
459243Sobrien *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: head/sys/dev/sound/pcm/channel.h 59020 2000-04-05 00:56:02Z cg $
27 */
28
29int chn_reinit(pcm_channel *c);
30int chn_write(pcm_channel *c, struct uio *buf);
31int chn_read(pcm_channel *c, struct uio *buf);
32int chn_sync(pcm_channel *c, int threshold);
33int chn_flush(pcm_channel *c);
34int chn_poll(pcm_channel *c, int ev, struct proc *p);
35
36int chn_init(pcm_channel *c, void *devinfo, int dir);
37int chn_setdir(pcm_channel *c, int dir);
38int chn_reset(pcm_channel *c);
39int chn_setvolume(pcm_channel *c, int left, int right);
40int chn_setspeed(pcm_channel *c, int speed);
41int chn_setformat(pcm_channel *c, u_int32_t fmt);
42int chn_setblocksize(pcm_channel *c, int blksz);
43int chn_trigger(pcm_channel *c, int go);
44int chn_getptr(pcm_channel *c);
45pcmchan_caps *chn_getcaps(pcm_channel *c);
46
47int chn_allocbuf(snd_dbuf *b, bus_dma_tag_t parent_dmat);
48void chn_resetbuf(pcm_channel *c);
49void chn_intr(pcm_channel *c);
50void chn_checkunderflow(pcm_channel *c);
51int chn_wrfeed(pcm_channel *c);
52int chn_rdfeed(pcm_channel *c);
53int chn_abort(pcm_channel *c);
54
55void buf_isadma(snd_dbuf *b, int go);
56int buf_isadmaptr(snd_dbuf *b);
57int chn_feedchain(pcm_channel *c);
58
59extern pcm_feeder feeder_root;
60
61#define PCMDIR_PLAY 1
62#define PCMDIR_REC -1
63
64#define PCMTRIG_START 1
65#define PCMTRIG_EMLDMAWR 2
66#define PCMTRIG_STOP 0
67#define PCMTRIG_ABORT -1
68
69#define CHN_F_READING           0x00000001  /* have a pending read */
70#define CHN_F_WRITING           0x00000002  /* have a pending write */
71#define CHN_F_CLOSING           0x00000004  /* a pending close */
72#define CHN_F_ABORTING          0x00000008  /* a pending abort */
73#define	CHN_F_PENDING_IO	(CHN_F_READING | CHN_F_WRITING)
74#define CHN_F_RUNNING		0x00000010  /* dma is running */
75#define CHN_F_TRIGGERED		0x00000020
76
77#define CHN_F_BUSY              0x00001000  /* has been opened 	*/
78#define	CHN_F_HAS_SIZE		0x00002000  /* user set block size */
79#define CHN_F_NBIO              0x00004000  /* do non-blocking i/o */
80#define CHN_F_INIT              0x00008000  /* changed parameters. need init */
81#define CHN_F_MAPPED		0x00010000  /* has been mmap()ed */
82
83
84#define CHN_F_RESET		(CHN_F_BUSY)
85
86/*
87 * This should be large enough to hold all pcm data between
88 * tsleeps in chn_{read,write} at the highest sample rate.
89 * (which is usually 48kHz * 16bit * stereo = 192000 bytes/sec)
90 */
91#define CHN_2NDBUFBLKSIZE	(2 * 1024)
92/* The total number of blocks per secondary buffer. */
93#define CHN_2NDBUFBLKNUM	(32)
94/* The size of a whole secondary buffer. */
95#define CHN_2NDBUFWHOLESIZE	(CHN_2NDBUFBLKSIZE * CHN_2NDBUFBLKNUM)
96