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
167 lines
6.2 KiB
C
167 lines
6.2 KiB
C
/* $NetBSD: auconv.h,v 1.12 2005/01/10 22:01:37 kent Exp $ */
|
|
|
|
/*-
|
|
* Copyright (c) 1997 The NetBSD Foundation, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to The NetBSD Foundation
|
|
* by Lennart Augustsson.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef _SYS_DEV_AUCONV_H_
|
|
#define _SYS_DEV_AUCONV_H_
|
|
#include <dev/audio_if.h>
|
|
|
|
/* common routines for stream_filter_t */
|
|
extern void stream_filter_set_fetcher(stream_filter_t *, stream_fetcher_t *);
|
|
extern void stream_filter_set_inputbuffer(stream_filter_t *, audio_stream_t *);
|
|
extern stream_filter_t *auconv_nocontext_filter_factory
|
|
(int (*)(stream_fetcher_t *, audio_stream_t *, int));
|
|
extern void auconv_nocontext_filter_dtor(struct stream_filter *);
|
|
#define FILTER_LOOP_PROLOGUE(SRC, SRCFRAME, DST, DSTFRAME, MAXUSED) \
|
|
do { \
|
|
const uint8_t *s; \
|
|
uint8_t *d; \
|
|
s = (SRC)->outp; \
|
|
d = (DST)->inp; \
|
|
for (; audio_stream_get_used(DST) < MAXUSED \
|
|
&& audio_stream_get_used(SRC) >= SRCFRAME; \
|
|
s = audio_stream_add_outp(SRC, s, SRCFRAME), \
|
|
d = audio_stream_add_inp(DST, d, DSTFRAME))
|
|
#define FILTER_LOOP_EPILOGUE(SRC, DST) \
|
|
(SRC)->outp = s; \
|
|
(DST)->inp = d; \
|
|
} while (/*CONSTCOND*/0)
|
|
|
|
|
|
/* Convert between signed and unsigned. */
|
|
extern stream_filter_factory_t change_sign8;
|
|
extern stream_filter_factory_t change_sign16;
|
|
/* Convert between little and big endian. */
|
|
extern stream_filter_factory_t swap_bytes;
|
|
extern stream_filter_factory_t swap_bytes_change_sign16;
|
|
/* Byte expansion/contraction */
|
|
extern stream_filter_factory_t linear8_to_linear16;
|
|
extern stream_filter_factory_t linear16_to_linear8;
|
|
/* sampling rate conversion (aurateconv.c) */
|
|
extern stream_filter_factory_t aurateconv;
|
|
|
|
struct audio_format {
|
|
/**
|
|
* Device-dependent audio drivers may use this field freely.
|
|
*/
|
|
void *driver_data;
|
|
|
|
/**
|
|
* combination of AUMODE_PLAY and AUMODE_RECORD
|
|
*/
|
|
int32_t mode;
|
|
|
|
/**
|
|
* Encoding type. AUDIO_ENCODING_*.
|
|
* Don't use AUDIO_ENCODING_SLINEAR/ULINEAR/LINEAR/LINEAR8
|
|
*/
|
|
u_int encoding;
|
|
|
|
/**
|
|
* The size of valid bits in one sample.
|
|
* It must be <= precision.
|
|
*/
|
|
u_int validbits;
|
|
|
|
/**
|
|
* The bit size of one sample.
|
|
* It must be >= validbits, and is usualy a multiple of 8.
|
|
*/
|
|
u_int precision;
|
|
|
|
/**
|
|
* The number of channels. >= 1
|
|
*/
|
|
u_int channels;
|
|
|
|
u_int channel_mask;
|
|
#define AUFMT_UNKNOWN_POSITION 0U
|
|
#define AUFMT_FRONT_LEFT 0x00001U /* USB audio compatible */
|
|
#define AUFMT_FRONT_RIGHT 0x00002U /* USB audio compatible */
|
|
#define AUFMT_FRONT_CENTER 0x00004U /* USB audio compatible */
|
|
#define AUFMT_LOW_FREQUENCY 0x00008U /* USB audio compatible */
|
|
#define AUFMT_BACK_LEFT 0x00010U /* USB audio compatible */
|
|
#define AUFMT_BACK_RIGHT 0x00020U /* USB audio compatible */
|
|
#define AUFMT_FRONT_LEFT_OF_CENTER 0x00040U /* USB audio compatible */
|
|
#define AUFMT_FRONT_RIGHT_OF_CENTER 0x00080U /* USB audio compatible */
|
|
#define AUFMT_FRONT_BACK_CENTER 0x00100U /* USB audio compatible */
|
|
#define AUFMT_FRONT_SIDE_LEFT 0x00200U /* USB audio compatible */
|
|
#define AUFMT_FRONT_SIDE_RIGHT 0x00400U /* USB audio compatible */
|
|
#define AUFMT_FRONT_TOP_CENTER 0x00800U /* USB audio compatible */
|
|
#define AUFMT_FRONT_TOP_FRONT_LEFT 0x01000U
|
|
#define AUFMT_FRONT_TOP_FRONT_CENTER 0x02000U
|
|
#define AUFMT_FRONT_TOP_FRONT_RIGHT 0x04000U
|
|
#define AUFMT_FRONT_TOP_BACK_LEFT 0x08000U
|
|
#define AUFMT_FRONT_TOP_BACK_CENTER 0x10000U
|
|
#define AUFMT_FRONT_TOP_BACK_RIGHT 0x20000U
|
|
|
|
#define AUFMT_MONAURAL AUFMT_FRONT_CENTER
|
|
#define AUFMT_STEREO (AUFMT_FRONT_LEFT | AUFMT_FRONT_RIGHT)
|
|
#define AUFMT_SURROUND4 (AUFMT_STEREO | AUFMT_BACK_LEFT \
|
|
| AUFMT_BACK_RIGHT)
|
|
#define AUFMT_DOLBY_5_1 (AUFMT_SURROUND4 | AUFMT_FRONT_CENTER \
|
|
| AUFMT_LOW_FREQUENCY)
|
|
|
|
/**
|
|
* 0: frequency[0] is lower limit, and frequency[1] is higher limit.
|
|
* 1-16: frequency[0] to frequency[frequency_type-1] are valid.
|
|
*/
|
|
u_int frequency_type;
|
|
|
|
#define AUFMT_MAX_FREQUENCIES 16
|
|
/**
|
|
* sampling rates
|
|
*/
|
|
u_int frequency[AUFMT_MAX_FREQUENCIES];
|
|
};
|
|
|
|
#define AUFMT_INVALIDATE(fmt) (fmt)->mode |= 0x80000000
|
|
#define AUFMT_VALIDATE(fmt) (fmt)->mode &= 0x7fffffff
|
|
#define AUFMT_IS_VALID(fmt) (((fmt)->mode & 0x80000000) == 0)
|
|
|
|
struct audio_encoding_set;
|
|
extern int auconv_set_converter(const struct audio_format *, int,
|
|
int, const audio_params_t *, int,
|
|
stream_filter_list_t *);
|
|
extern int auconv_create_encodings(const struct audio_format *, int,
|
|
struct audio_encoding_set **);
|
|
extern int auconv_delete_encodings(struct audio_encoding_set *);
|
|
extern int auconv_query_encoding(const struct audio_encoding_set *,
|
|
audio_encoding_t *);
|
|
|
|
#endif /* !_SYS_DEV_AUCONV_H_ */
|