23b5d91433
audio framework
Summary of changes:
* struct audio_params
- remove sw_code, factor, factor_denom, hw_sample_rate,
hw_encoding ,hw_precision, and hw_channels. Conversion information
is conveyed by stream_filter_list_t.
- change the type of sample_rate: u_long -> u_int
- add `validbits,' which represents the valid data size in
precision bits. It is required in order to distinguish 24/32bit
from 24/24bit or 32/32bit.
* audio_hw_if
- add two parameters to set_params()
stream_filter_list_t *pfil, stream_filter_list *rfil
A HW driver should set filter recipes for requested formats
- constify audio_params parameters of trigger_output() and
trigger_input(). They represent audio formats for the hardware.
- make open() and close() optional
- add int (AUMODE_PLAY or AUMODE_RECORD) and audio_params_t parameters
to round_blocksize()
* sw_code is replaced with stream_filter_t.
stream_filer_t converts audio data in an input buffer and writes
into another output buffer unlike sw_code, which converts data in
single buffer.
converters in dev/auconv.c, dev/mulaw.c, dev/aurateconv.c,
dev/tc/bba.c, dev/ic/msm6258.c, and arch/arm/iomd/vidcaudio.c are
reimplemented as stream_filter_t
* MI audio
- audiosetinfo() builds filter pipelines from stream_filter_list_t
filled by audio_hw_if::set_params()
- audiosetinfo() returns with EINVAL if mmapped and set_params()
requests filters
- audio_write(), audio_pint(), and audio_rint() invoke a filter
pipeline.
- ioctl() for FIONREAD, AUDIO_WSEEK, AUDIO_GETIOFFS,
AUDIO_GETOOFFS, and audio_prinfo::{seek,samples} for
AUDIO_GETINFO handle values for a buffer nearest to userland.
* add `struct device *' parameter to ac97_attach()
* all of audio HW drivers follow audio_hw_if and ac97 changes
224 lines
8.6 KiB
C
224 lines
8.6 KiB
C
/* $NetBSD: audiovar.h,v 1.32 2005/01/10 22:01:37 kent Exp $ */
|
|
|
|
/*-
|
|
* Copyright (c) 2002 The NetBSD Foundation, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
* by TAMURA Kent
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* This product includes software developed by the NetBSD
|
|
* Foundation, Inc. and its contributors.
|
|
* 4. Neither the name of The NetBSD Foundation nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 1991-1993 Regents of the University of California.
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* This product includes software developed by the Computer Systems
|
|
* Engineering Group at Lawrence Berkeley Laboratory.
|
|
* 4. Neither the name of the University nor of the Laboratory may be used
|
|
* to endorse or promote products derived from this software without
|
|
* specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* From: Header: audiovar.h,v 1.3 93/07/18 14:07:25 mccanne Exp (LBL)
|
|
*/
|
|
#ifndef _SYS_DEV_AUDIOVAR_H_
|
|
#define _SYS_DEV_AUDIOVAR_H_
|
|
#include <dev/audio_if.h>
|
|
|
|
/*
|
|
* Initial/default block duration is both configurable and patchable.
|
|
*/
|
|
#ifndef AUDIO_BLK_MS
|
|
#define AUDIO_BLK_MS 50 /* 50 ms */
|
|
#endif
|
|
|
|
#ifndef AU_RING_SIZE
|
|
#define AU_RING_SIZE 65536
|
|
#endif
|
|
|
|
#define AUMINBUF 512
|
|
#define AUMINBLK 32
|
|
#define AUMINNOBLK 3
|
|
struct audio_ringbuffer {
|
|
audio_stream_t s;
|
|
int blksize; /* I/O block size (bytes) */
|
|
int maxblks; /* no of blocks in ring */
|
|
int usedlow; /* start writer when used falls below this */
|
|
int usedhigh; /* stop writer when used goes above this */
|
|
u_long stamp; /* bytes transferred */
|
|
u_long stamp_last; /* old value of bytes transferred */
|
|
u_long fstamp; /* bytes transferred from/to the buffer near to userland */
|
|
u_long drops; /* missed samples from over/underrun */
|
|
u_long pdrops; /* paused samples */
|
|
boolean_t pause; /* transfer is paused */
|
|
boolean_t copying; /* data is being copied */
|
|
boolean_t needfill; /* buffer needs filling when copying is done */
|
|
boolean_t mmapped; /* device is mmap()-ed */
|
|
};
|
|
|
|
#define AUDIO_N_PORTS 4
|
|
|
|
struct au_mixer_ports {
|
|
int index; /* index of port-selector mixerctl */
|
|
int master; /* index of master mixerctl */
|
|
int nports; /* number of selectable ports */
|
|
boolean_t isenum; /* selector is enum type */
|
|
u_int allports; /* all aumasks or'd */
|
|
u_int aumask[AUDIO_N_PORTS]; /* exposed value of "ports" */
|
|
u_int misel [AUDIO_N_PORTS]; /* ord of port, for selector */
|
|
u_int miport[AUDIO_N_PORTS]; /* index of port's mixerctl */
|
|
boolean_t isdual; /* has working mixerout */
|
|
int mixerout; /* ord of mixerout, for dual case */
|
|
int cur_port; /* the port that gain actually controls when
|
|
mixerout is selected, for dual case */
|
|
};
|
|
|
|
/*
|
|
* Software state, per audio device.
|
|
*/
|
|
struct audio_softc {
|
|
struct device dev;
|
|
void *hw_hdl; /* Hardware driver handle */
|
|
const struct audio_hw_if *hw_if; /* Hardware interface */
|
|
struct device *sc_dev; /* Hardware device struct */
|
|
u_char sc_open; /* single use device */
|
|
#define AUOPEN_READ 0x01
|
|
#define AUOPEN_WRITE 0x02
|
|
u_char sc_mode; /* bitmask for RECORD/PLAY */
|
|
|
|
struct selinfo sc_wsel; /* write selector */
|
|
struct selinfo sc_rsel; /* read selector */
|
|
struct proc *sc_async_audio; /* process who wants audio SIGIO */
|
|
struct mixer_asyncs {
|
|
struct mixer_asyncs *next;
|
|
struct proc *proc;
|
|
} *sc_async_mixer; /* processes who want mixer SIGIO */
|
|
|
|
/* Sleep channels for reading and writing. */
|
|
int sc_rchan;
|
|
int sc_wchan;
|
|
|
|
boolean_t sc_blkset; /* Blocksize has been set */
|
|
|
|
uint8_t *sc_sil_start; /* start of silence in buffer */
|
|
int sc_sil_count; /* # of silence bytes */
|
|
|
|
boolean_t sc_rbus; /* input DMA in progress */
|
|
boolean_t sc_pbus; /* output DMA in progress */
|
|
|
|
/**
|
|
* userland
|
|
* | write(2) & uiomove(9)
|
|
* sc_pstreams[0] <sc_pparams> == sc_pustream;
|
|
* | sc_pfilters[0]
|
|
* sc_pstreams[1] <list_t::filters[n-1].param>
|
|
* :
|
|
* sc_pstreams[n-1] <list_t::filters[1].param>
|
|
* | sc_pfilters[n-1]
|
|
* sc_pr <list_t::filters[0].param>
|
|
* |
|
|
* hardware
|
|
*/
|
|
audio_params_t sc_pparams; /* play encoding parameters */
|
|
audio_stream_t *sc_pustream; /* the first buffer */
|
|
int sc_npfilters; /* number of filters */
|
|
audio_stream_t sc_pstreams[AUDIO_MAX_FILTERS];
|
|
stream_filter_t *sc_pfilters[AUDIO_MAX_FILTERS];
|
|
struct audio_ringbuffer sc_pr; /* Play ring */
|
|
|
|
/**
|
|
* hardware
|
|
* |
|
|
* sc_rr <list_t::filters[0].param>
|
|
* | sc_rfilters[0]
|
|
* sc_rstreams[0] <list_t::filters[1].param>
|
|
* | sc_rfilters[1]
|
|
* sc_rstreams[1] <list_t::filters[2].param>
|
|
* :
|
|
* | sc_rfilters[n-1]
|
|
* sc_rstreams[n-1] <sc_rparams> == sc_rustream
|
|
* | uiomove(9) & read(2)
|
|
* userland
|
|
*/
|
|
struct audio_ringbuffer sc_rr; /* Record ring */
|
|
int sc_nrfilters; /* number of filters */
|
|
stream_filter_t *sc_rfilters[AUDIO_MAX_FILTERS];
|
|
audio_stream_t sc_rstreams[AUDIO_MAX_FILTERS];
|
|
audio_stream_t *sc_rustream; /* the last buffer */
|
|
audio_params_t sc_rparams; /* record encoding parameters */
|
|
|
|
int sc_eof; /* EOF, i.e. zero sized write, counter */
|
|
u_long sc_wstamp; /* # of bytes read with read(2) */
|
|
u_long sc_playdrop;
|
|
|
|
int sc_full_duplex; /* device in full duplex mode */
|
|
|
|
struct au_mixer_ports sc_inports, sc_outports;
|
|
int sc_monitor_port;
|
|
|
|
int sc_refcnt;
|
|
boolean_t sc_dying;
|
|
|
|
#ifdef AUDIO_INTR_TIME
|
|
u_long sc_pfirstintr; /* first time we saw a play interrupt */
|
|
int sc_pnintr; /* number of interrupts */
|
|
u_long sc_plastintr; /* last time we saw a play interrupt */
|
|
long sc_pblktime; /* nominal time between interrupts */
|
|
u_long sc_rfirstintr; /* first time we saw a rec interrupt */
|
|
int sc_rnintr; /* number of interrupts */
|
|
u_long sc_rlastintr; /* last time we saw a rec interrupt */
|
|
long sc_rblktime; /* nominal time between interrupts */
|
|
#endif
|
|
};
|
|
|
|
#endif /* _SYS_DEV_AUDIOVAR_H_ */
|