1 /*- 2 * Copyright (c) 1999 Cameron Grant <cg@freebsd.org> 3 * All rights reserved. 4 * 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: src/sys/dev/sound/pcm/channel.h,v 1.31.2.1 2005/12/30 19:55:54 netchild Exp $ 27 * $DragonFly: src/sys/dev/sound/pcm/channel.h,v 1.6 2007/06/16 20:07:22 dillon Exp $ 28 */ 29 30 struct pcmchan_children { 31 SLIST_ENTRY(pcmchan_children) link; 32 struct pcm_channel *channel; 33 }; 34 35 struct pcmchan_caps { 36 u_int32_t minspeed, maxspeed; 37 u_int32_t *fmtlist; 38 u_int32_t caps; 39 }; 40 41 #define CHN_NAMELEN 32 42 struct pcm_channel { 43 kobj_t methods; 44 45 int num; 46 pid_t pid; 47 int refcount; 48 struct pcm_feeder *feeder; 49 u_int32_t align; 50 51 int volume; 52 u_int32_t speed; 53 u_int32_t format; 54 u_int32_t flags; 55 u_int32_t feederflags; 56 u_int32_t blocks; 57 58 int direction; 59 unsigned int interrupts, xruns; 60 struct snd_dbuf *bufhard, *bufsoft; 61 struct snddev_info *parentsnddev; 62 struct pcm_channel *parentchannel; 63 void *devinfo; 64 device_t dev; 65 char name[CHN_NAMELEN]; 66 sndlock_t lock; 67 SLIST_HEAD(, pcmchan_children) children; 68 }; 69 70 #include "channel_if.h" 71 72 int chn_reinit(struct pcm_channel *c); 73 int chn_write(struct pcm_channel *c, struct uio *buf, int ioflags); 74 int chn_read(struct pcm_channel *c, struct uio *buf, int ioflags); 75 u_int32_t chn_start(struct pcm_channel *c, int force); 76 int chn_sync(struct pcm_channel *c, int threshold); 77 int chn_flush(struct pcm_channel *c); 78 int chn_poll(struct pcm_channel *c, int ev, struct thread *td); 79 80 int chn_init(struct pcm_channel *c, void *devinfo, int dir, int direction); 81 int chn_kill(struct pcm_channel *c); 82 int chn_setdir(struct pcm_channel *c, int dir); 83 int chn_reset(struct pcm_channel *c, u_int32_t fmt); 84 int chn_setvolume(struct pcm_channel *c, int left, int right); 85 int chn_setspeed(struct pcm_channel *c, int speed); 86 int chn_setformat(struct pcm_channel *c, u_int32_t fmt); 87 int chn_setblocksize(struct pcm_channel *c, int blkcnt, int blksz); 88 int chn_trigger(struct pcm_channel *c, int go); 89 int chn_getptr(struct pcm_channel *c); 90 struct pcmchan_caps *chn_getcaps(struct pcm_channel *c); 91 u_int32_t chn_getformats(struct pcm_channel *c); 92 93 void chn_resetbuf(struct pcm_channel *c); 94 void chn_intr(struct pcm_channel *c); 95 int chn_wrfeed(struct pcm_channel *c); 96 int chn_rdfeed(struct pcm_channel *c); 97 int chn_abort(struct pcm_channel *c); 98 99 void chn_wrupdate(struct pcm_channel *c); 100 void chn_rdupdate(struct pcm_channel *c); 101 102 int chn_notify(struct pcm_channel *c, u_int32_t flags); 103 void chn_lock(struct pcm_channel *c); 104 void chn_unlock(struct pcm_channel *c); 105 106 #ifdef USING_MUTEX 107 #define CHN_LOCK(c) snd_mtxlock(((c)->lock)) 108 #define CHN_UNLOCK(c) snd_mtxunlock(((c)->lock)) 109 #define CHN_LOCKASSERT(c) 110 #else 111 #define CHN_LOCK(c) 112 #define CHN_UNLOCK(c) 113 #define CHN_LOCKASSERT(c) 114 #endif 115 116 int fmtvalid(u_int32_t fmt, u_int32_t *fmtlist); 117 118 #define PCMDIR_VIRTUAL 2 119 #define PCMDIR_PLAY 1 120 #define PCMDIR_REC -1 121 122 #define PCMTRIG_START 1 123 #define PCMTRIG_EMLDMAWR 2 124 #define PCMTRIG_EMLDMARD 3 125 #define PCMTRIG_STOP 0 126 #define PCMTRIG_ABORT -1 127 128 #define CHN_F_CLOSING 0x00000004 /* a pending close */ 129 #define CHN_F_ABORTING 0x00000008 /* a pending abort */ 130 #define CHN_F_RUNNING 0x00000010 /* dma is running */ 131 #define CHN_F_TRIGGERED 0x00000020 132 #define CHN_F_NOTRIGGER 0x00000040 133 134 #define CHN_F_BUSY 0x00001000 /* has been opened */ 135 #define CHN_F_HAS_SIZE 0x00002000 /* user set block size */ 136 #define CHN_F_NBIO 0x00004000 /* do non-blocking i/o */ 137 #define CHN_F_MAPPED 0x00010000 /* has been mmap()ed */ 138 #define CHN_F_DEAD 0x00020000 139 #define CHN_F_BADSETTING 0x00040000 140 #define CHN_F_SETBLOCKSIZE 0x00080000 141 #define CHN_F_HAS_VCHAN 0x00100000 142 143 #define CHN_F_VIRTUAL 0x10000000 /* not backed by hardware */ 144 145 #define CHN_F_RESET (CHN_F_BUSY | CHN_F_DEAD | \ 146 CHN_F_HAS_VCHAN | CHN_F_VIRTUAL) 147 148 149 #define CHN_N_RATE 0x00000001 150 #define CHN_N_FORMAT 0x00000002 151 #define CHN_N_VOLUME 0x00000004 152 #define CHN_N_BLOCKSIZE 0x00000008 153 #define CHN_N_TRIGGER 0x00000010 154 155 /* 156 * This should be large enough to hold all pcm data between 157 * tsleeps in chn_{read,write} at the highest sample rate. 158 * (which is usually 48kHz * 16bit * stereo = 192000 bytes/sec) 159 */ 160 #define CHN_2NDBUFBLKSIZE (2 * 1024) 161 /* The total number of blocks per secondary bufhard. */ 162 #define CHN_2NDBUFBLKNUM (32) 163 /* The size of a whole secondary bufhard. */ 164 #define CHN_2NDBUFMAXSIZE (131072) 165 166 #define CHANNEL_DECLARE(name) static DEFINE_CLASS(name, name ## _methods, sizeof(struct kobj)) 167