2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2005-2009 Ariff Abdullah <ariff@FreeBSD.org>
5 * Copyright (c) 1999 Cameron Grant <cg@FreeBSD.org>
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 struct pcm_feederdesc {
41 struct pcm_feederdesc *desc;
48 struct pcm_feederdesc *desc, desc_static;
50 struct feeder_class *class;
51 struct pcm_feeder *source, *parent;
55 void feeder_register(void *p);
56 struct feeder_class *feeder_getclass(struct pcm_feederdesc *desc);
58 u_int32_t snd_fmtscore(u_int32_t fmt);
59 u_int32_t snd_fmtbestbit(u_int32_t fmt, u_int32_t *fmts);
60 u_int32_t snd_fmtbestchannel(u_int32_t fmt, u_int32_t *fmts);
61 u_int32_t snd_fmtbest(u_int32_t fmt, u_int32_t *fmts);
63 int chn_addfeeder(struct pcm_channel *c, struct feeder_class *fc,
64 struct pcm_feederdesc *desc);
65 int chn_removefeeder(struct pcm_channel *c);
66 struct pcm_feeder *chn_findfeeder(struct pcm_channel *c, u_int32_t type);
67 void feeder_printchain(struct pcm_feeder *head);
68 int feeder_chain(struct pcm_channel *);
70 #define FEEDER_DECLARE(feeder, pdata) \
71 static struct feeder_class feeder ## _class = { \
73 .methods = feeder ## _methods, \
74 .size = sizeof(struct pcm_feeder), \
75 .desc = feeder ## _desc, \
78 SYSINIT(feeder, SI_SUB_DRIVERS, SI_ORDER_ANY, feeder_register, \
110 #define FEEDRATE_RATEMIN 1
111 #define FEEDRATE_RATEMAX 2016000 /* 48000 * 42 */
112 #define FEEDRATE_MIN 1
113 #define FEEDRATE_MAX 0x7fffff /* sign 24bit ~ 8ghz ! */
114 #define FEEDRATE_ROUNDHZ 25
115 #define FEEDRATE_ROUNDHZ_MIN 0
116 #define FEEDRATE_ROUNDHZ_MAX 500
118 extern int feeder_rate_min;
119 extern int feeder_rate_max;
120 extern int feeder_rate_round;
121 extern int feeder_rate_quality;
137 int feeder_eq_validrate(uint32_t);
138 void feeder_eq_initsys(device_t);
149 int feeder_volume_apply_matrix(struct pcm_feeder *, struct pcmchan_matrix *);
152 int feeder_matrix_default_id(uint32_t);
153 struct pcmchan_matrix *feeder_matrix_default_channel_map(uint32_t);
155 uint32_t feeder_matrix_default_format(uint32_t);
157 int feeder_matrix_format_id(uint32_t);
158 struct pcmchan_matrix *feeder_matrix_format_map(uint32_t);
160 struct pcmchan_matrix *feeder_matrix_id_map(int);
162 int feeder_matrix_setup(struct pcm_feeder *, struct pcmchan_matrix *,
163 struct pcmchan_matrix *);
164 int feeder_matrix_compare(struct pcmchan_matrix *, struct pcmchan_matrix *);
166 /* 4Front OSS stuffs */
167 int feeder_matrix_oss_get_channel_order(struct pcmchan_matrix *,
168 unsigned long long *);
169 int feeder_matrix_oss_set_channel_order(struct pcmchan_matrix *,
170 unsigned long long *);
177 FEEDMATRIX_CHANNELS_IN,
178 FEEDMATRIX_CHANNELS_OUT,
183 FEEDMATRIX_TYPE_NONE,
184 FEEDMATRIX_TYPE_AUTO,
190 #define FEEDMATRIX_TYPE_STEREO_TO_MONO FEEDMATRIX_TYPE_2X1
191 #define FEEDMATRIX_TYPE_MONO_TO_STEREO FEEDMATRIX_TYPE_1X2
192 #define FEEDMATRIX_TYPE_SWAP_STEREO FEEDMATRIX_TYPE_2X2
193 #define FEEDMATRIX_MAP(x, y) ((((x) & 0x3f) << 6) | ((y) & 0x3f))
194 #define FEEDMATRIX_MAP_SRC(x) ((x) & 0x3f)
195 #define FEEDMATRIX_MAP_DST(x) (((x) >> 6) & 0x3f)
199 * By default, various feeders only deal with sign 16/32 bit native-endian
200 * since it should provide the fastest processing path. Processing 8bit samples
201 * is too noisy due to limited dynamic range, while 24bit is quite slow due to
202 * unnatural per-byte read/write. However, for debugging purposes, ensuring
203 * implementation correctness and torture test, the following can be defined:
205 * SND_FEEDER_MULTIFORMAT - Compile all type of converters, but force
206 * 8bit samples to be converted to 16bit
207 * native-endian for better dynamic range.
208 * Process 24bit samples natively.
209 * SND_FEEDER_FULL_MULTIFORMAT - Ditto, but process 8bit samples natively.
211 #ifdef SND_FEEDER_FULL_MULTIFORMAT
212 #undef SND_FEEDER_MULTIFORMAT
213 #define SND_FEEDER_MULTIFORMAT 1