soundcard.h revision 1.7
1/*	$OpenBSD: soundcard.h,v 1.7 2002/02/16 21:27:27 millert Exp $	*/
2/*	$NetBSD: soundcard.h,v 1.11 2001/05/09 21:49:58 augustss Exp $	*/
3
4/*-
5 * Copyright (c) 1997 The NetBSD Foundation, Inc.
6 * All rights reserved.
7 *
8 * This code is derived from software contributed to The NetBSD Foundation
9 * by Lennart Augustsson.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 *    notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 *    notice, this list of conditions and the following disclaimer in the
18 *    documentation and/or other materials provided with the distribution.
19 * 3. All advertising materials mentioning features or use of this software
20 *    must display the following acknowledgement:
21 *        This product includes software developed by the NetBSD
22 *        Foundation, Inc. and its contributors.
23 * 4. Neither the name of The NetBSD Foundation nor the names of its
24 *    contributors may be used to endorse or promote products derived
25 *    from this software without specific prior written permission.
26 *
27 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
28 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
29 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
30 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
31 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37 * POSSIBILITY OF SUCH DAMAGE.
38 */
39
40/*
41 * WARNING!  WARNING!
42 * This is an OSS (Linux) audio emulator.
43 * Use the Native NetBSD API for developing new code, and this
44 * only for compiling Linux programs.
45 */
46
47#ifndef _SOUNDCARD_H_
48#define _SOUNDCARD_H_
49
50#ifndef	_IOWR
51#include <sys/ioccom.h>
52#endif	/* !_IOWR */
53
54#define SOUND_VERSION	0x030001
55
56#define	SNDCTL_DSP_RESET		_IO  ('P', 0)
57#define	SNDCTL_DSP_SYNC			_IO  ('P', 1)
58#define	SNDCTL_DSP_SPEED		_IOWR('P', 2, int)
59#define	SOUND_PCM_READ_RATE		_IOR ('P', 2, int)
60#define	SNDCTL_DSP_STEREO		_IOWR('P', 3, int)
61#define	SNDCTL_DSP_GETBLKSIZE		_IOWR('P', 4, int)
62#define	SNDCTL_DSP_SETFMT		_IOWR('P', 5, int)
63#define	 AFMT_QUERY			0x00000000
64#define	 AFMT_MU_LAW			0x00000001
65#define	 AFMT_A_LAW			0x00000002
66#define	 AFMT_IMA_ADPCM			0x00000004
67#define	 AFMT_U8			0x00000008
68#define	 AFMT_S16_LE			0x00000010
69#define	 AFMT_S16_BE			0x00000020
70#define	 AFMT_S8			0x00000040
71#define	 AFMT_U16_LE			0x00000080
72#define	 AFMT_U16_BE			0x00000100
73#define	 AFMT_MPEG			0x00000200
74#define SNDCTL_DSP_SAMPLESIZE		SNDCTL_DSP_SETFMT
75#define	SOUND_PCM_READ_BITS		_IOR ('P', 5, int)
76#define	SNDCTL_DSP_CHANNELS		_IOWR('P', 6, int)
77#define SOUND_PCM_WRITE_CHANNELS	SNDCTL_DSP_CHANNELS
78#define	SOUND_PCM_READ_CHANNELS		_IOR ('P', 6, int)
79#define SOUND_PCM_WRITE_FILTER		_IOWR('P', 7, int)
80#define SOUND_PCM_READ_FILTER		_IOR ('P', 7, int)
81#define	SNDCTL_DSP_POST			_IO  ('P', 8)
82#define SNDCTL_DSP_SUBDIVIDE		_IOWR('P', 9, int)
83#define	SNDCTL_DSP_SETFRAGMENT		_IOWR('P', 10, int)
84#define	SNDCTL_DSP_GETFMTS		_IOR ('P', 11, int)
85#define SNDCTL_DSP_GETOSPACE		_IOR ('P',12, struct audio_buf_info)
86#define SNDCTL_DSP_GETISPACE		_IOR ('P',13, struct audio_buf_info)
87#define SNDCTL_DSP_NONBLOCK		_IO  ('P',14)
88#define SNDCTL_DSP_GETCAPS		_IOR ('P',15, int)
89# define DSP_CAP_REVISION		0x000000ff
90# define DSP_CAP_DUPLEX			0x00000100
91# define DSP_CAP_REALTIME		0x00000200
92# define DSP_CAP_BATCH			0x00000400
93# define DSP_CAP_COPROC			0x00000800
94# define DSP_CAP_TRIGGER		0x00001000
95# define DSP_CAP_MMAP			0x00002000
96#define SNDCTL_DSP_GETTRIGGER		_IOR ('P', 16, int)
97#define SNDCTL_DSP_SETTRIGGER		_IOW ('P', 16, int)
98# define PCM_ENABLE_INPUT		0x00000001
99# define PCM_ENABLE_OUTPUT		0x00000002
100#define SNDCTL_DSP_GETIPTR		_IOR ('P', 17, struct count_info)
101#define SNDCTL_DSP_GETOPTR		_IOR ('P', 18, struct count_info)
102#define SNDCTL_DSP_MAPINBUF		_IOR ('P', 19, struct buffmem_desc)
103#define SNDCTL_DSP_MAPOUTBUF		_IOR ('P', 20, struct buffmem_desc)
104#define SNDCTL_DSP_SETSYNCRO		_IO  ('P', 21)
105#define SNDCTL_DSP_SETDUPLEX		_IO  ('P', 22)
106#define SNDCTL_DSP_PROFILE		_IOW ('P', 23, int)
107#define	  APF_NORMAL			0
108#define	  APF_NETWORK			1
109#define   APF_CPUINTENS			2
110
111/* Need native 16 bit format which depends on byte order */
112/* XXX This isn't really a good way, but I don't want to
113 * include all of endian.h because it contains a lot
114 * junk symbols.  [augustss]
115 */
116#ifndef _POSIX_SOURCE
117#define _POSIX_SOURCE		/* avoid dragging in a lot of junk */
118#include <machine/endian.h>
119#undef _POSIX_SOURCE
120#else
121#include <machine/endian.h>
122#endif
123#if _QUAD_LOWWORD == 0
124#define  AFMT_S16_NE AFMT_S16_LE
125#else
126#define  AFMT_S16_NE AFMT_S16_BE
127#endif
128
129
130/* Aliases */
131#define SOUND_PCM_WRITE_BITS		SNDCTL_DSP_SETFMT
132#define SOUND_PCM_WRITE_RATE		SNDCTL_DSP_SPEED
133#define SOUND_PCM_POST			SNDCTL_DSP_POST
134#define SOUND_PCM_RESET			SNDCTL_DSP_RESET
135#define SOUND_PCM_SYNC			SNDCTL_DSP_SYNC
136#define SOUND_PCM_SUBDIVIDE		SNDCTL_DSP_SUBDIVIDE
137#define SOUND_PCM_SETFRAGMENT		SNDCTL_DSP_SETFRAGMENT
138#define SOUND_PCM_GETFMTS		SNDCTL_DSP_GETFMTS
139#define SOUND_PCM_SETFMT		SNDCTL_DSP_SETFMT
140#define SOUND_PCM_GETOSPACE		SNDCTL_DSP_GETOSPACE
141#define SOUND_PCM_GETISPACE		SNDCTL_DSP_GETISPACE
142#define SOUND_PCM_NONBLOCK		SNDCTL_DSP_NONBLOCK
143#define SOUND_PCM_GETCAPS		SNDCTL_DSP_GETCAPS
144#define SOUND_PCM_GETTRIGGER		SNDCTL_DSP_GETTRIGGER
145#define SOUND_PCM_SETTRIGGER		SNDCTL_DSP_SETTRIGGER
146#define SOUND_PCM_SETSYNCRO		SNDCTL_DSP_SETSYNCRO
147#define SOUND_PCM_GETIPTR		SNDCTL_DSP_GETIPTR
148#define SOUND_PCM_GETOPTR		SNDCTL_DSP_GETOPTR
149#define SOUND_PCM_MAPINBUF		SNDCTL_DSP_MAPINBUF
150#define SOUND_PCM_MAPOUTBUF		SNDCTL_DSP_MAPOUTBUF
151
152/* Mixer defines */
153#define SOUND_MIXER_FIRST		0
154#define SOUND_MIXER_NRDEVICES		25
155
156#define SOUND_MIXER_VOLUME		0
157#define SOUND_MIXER_BASS		1
158#define SOUND_MIXER_TREBLE		2
159#define SOUND_MIXER_SYNTH		3
160#define SOUND_MIXER_PCM			4
161#define SOUND_MIXER_SPEAKER		5
162#define SOUND_MIXER_LINE		6
163#define SOUND_MIXER_MIC			7
164#define SOUND_MIXER_CD			8
165#define SOUND_MIXER_IMIX		9
166#define SOUND_MIXER_ALTPCM		10
167#define SOUND_MIXER_RECLEV		11
168#define SOUND_MIXER_IGAIN		12
169#define SOUND_MIXER_OGAIN		13
170#define SOUND_MIXER_LINE1		14
171#define SOUND_MIXER_LINE2		15
172#define SOUND_MIXER_LINE3		16
173#define SOUND_MIXER_DIGITAL1		17
174#define SOUND_MIXER_DIGITAL2		18
175#define SOUND_MIXER_DIGITAL3		19
176#define SOUND_MIXER_PHONEIN		20
177#define SOUND_MIXER_PHONEOUT		21
178#define SOUND_MIXER_VIDEO		22
179#define SOUND_MIXER_RADIO		23
180#define SOUND_MIXER_MONITOR		24
181
182#define SOUND_ONOFF_MIN			28
183#define SOUND_ONOFF_MAX			30
184
185#define SOUND_MIXER_NONE		31
186
187#define SOUND_DEVICE_LABELS	{"Vol  ", "Bass ", "Trebl", "Synth", "Pcm  ", "Spkr ", "Line ", \
188				 "Mic  ", "CD   ", "Mix  ", "Pcm2 ", "Rec  ", "IGain", "OGain", \
189				 "Line1", "Line2", "Line3", "Digital1", "Digital2", "Digital3", \
190				 "PhoneIn", "PhoneOut", "Video", "Radio", "Monitor"}
191
192#define SOUND_DEVICE_NAMES	{"vol", "bass", "treble", "synth", "pcm", "speaker", "line", \
193				 "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain", \
194				 "line1", "line2", "line3", "dig1", "dig2", "dig3", \
195				 "phin", "phout", "video", "radio", "monitor"}
196
197#define SOUND_MIXER_RECSRC		0xff
198#define SOUND_MIXER_DEVMASK		0xfe
199#define SOUND_MIXER_RECMASK		0xfd
200#define SOUND_MIXER_CAPS		0xfc
201#define  SOUND_CAP_EXCL_INPUT		1
202#define SOUND_MIXER_STEREODEVS		0xfb
203
204#define MIXER_READ(dev)			_IOR('M', dev, int)
205
206#define SOUND_MIXER_READ_RECSRC		MIXER_READ(SOUND_MIXER_RECSRC)
207#define SOUND_MIXER_READ_DEVMASK	MIXER_READ(SOUND_MIXER_DEVMASK)
208#define SOUND_MIXER_READ_RECMASK	MIXER_READ(SOUND_MIXER_RECMASK)
209#define SOUND_MIXER_READ_STEREODEVS	MIXER_READ(SOUND_MIXER_STEREODEVS)
210#define SOUND_MIXER_READ_CAPS		MIXER_READ(SOUND_MIXER_CAPS)
211
212#define SOUND_MIXER_READ_VOLUME		MIXER_READ(SOUND_MIXER_VOLUME)
213#define SOUND_MIXER_READ_BASS		MIXER_READ(SOUND_MIXER_BASS)
214#define SOUND_MIXER_READ_TREBLE		MIXER_READ(SOUND_MIXER_TREBLE)
215#define SOUND_MIXER_READ_SYNTH		MIXER_READ(SOUND_MIXER_SYNTH)
216#define SOUND_MIXER_READ_PCM		MIXER_READ(SOUND_MIXER_PCM)
217#define SOUND_MIXER_READ_SPEAKER	MIXER_READ(SOUND_MIXER_SPEAKER)
218#define SOUND_MIXER_READ_LINE		MIXER_READ(SOUND_MIXER_LINE)
219#define SOUND_MIXER_READ_MIC		MIXER_READ(SOUND_MIXER_MIC)
220#define SOUND_MIXER_READ_CD		MIXER_READ(SOUND_MIXER_CD)
221#define SOUND_MIXER_READ_IMIX		MIXER_READ(SOUND_MIXER_IMIX)
222#define SOUND_MIXER_READ_ALTPCM		MIXER_READ(SOUND_MIXER_ALTPCM)
223#define SOUND_MIXER_READ_RECLEV		MIXER_READ(SOUND_MIXER_RECLEV)
224#define SOUND_MIXER_READ_IGAIN		MIXER_READ(SOUND_MIXER_IGAIN)
225#define SOUND_MIXER_READ_OGAIN		MIXER_READ(SOUND_MIXER_OGAIN)
226#define SOUND_MIXER_READ_LINE1		MIXER_READ(SOUND_MIXER_LINE1)
227#define SOUND_MIXER_READ_LINE2		MIXER_READ(SOUND_MIXER_LINE2)
228#define SOUND_MIXER_READ_LINE3		MIXER_READ(SOUND_MIXER_LINE3)
229
230#define MIXER_WRITE(dev)		_IOW ('M', dev, int)
231#define MIXER_WRITE_R(dev)		_IOWR('M', dev, int)
232
233#define SOUND_MIXER_WRITE_RECSRC	MIXER_WRITE(SOUND_MIXER_RECSRC)
234#define SOUND_MIXER_WRITE_R_RECSRC	MIXER_WRITE_R(SOUND_MIXER_RECSRC)
235
236#define SOUND_MIXER_WRITE_VOLUME	MIXER_WRITE(SOUND_MIXER_VOLUME)
237#define SOUND_MIXER_WRITE_BASS		MIXER_WRITE(SOUND_MIXER_BASS)
238#define SOUND_MIXER_WRITE_TREBLE	MIXER_WRITE(SOUND_MIXER_TREBLE)
239#define SOUND_MIXER_WRITE_SYNTH		MIXER_WRITE(SOUND_MIXER_SYNTH)
240#define SOUND_MIXER_WRITE_PCM		MIXER_WRITE(SOUND_MIXER_PCM)
241#define SOUND_MIXER_WRITE_SPEAKER	MIXER_WRITE(SOUND_MIXER_SPEAKER)
242#define SOUND_MIXER_WRITE_LINE		MIXER_WRITE(SOUND_MIXER_LINE)
243#define SOUND_MIXER_WRITE_MIC		MIXER_WRITE(SOUND_MIXER_MIC)
244#define SOUND_MIXER_WRITE_CD		MIXER_WRITE(SOUND_MIXER_CD)
245#define SOUND_MIXER_WRITE_IMIX		MIXER_WRITE(SOUND_MIXER_IMIX)
246#define SOUND_MIXER_WRITE_ALTPCM	MIXER_WRITE(SOUND_MIXER_ALTPCM)
247#define SOUND_MIXER_WRITE_RECLEV	MIXER_WRITE(SOUND_MIXER_RECLEV)
248#define SOUND_MIXER_WRITE_IGAIN		MIXER_WRITE(SOUND_MIXER_IGAIN)
249#define SOUND_MIXER_WRITE_OGAIN		MIXER_WRITE(SOUND_MIXER_OGAIN)
250#define SOUND_MIXER_WRITE_LINE1		MIXER_WRITE(SOUND_MIXER_LINE1)
251#define SOUND_MIXER_WRITE_LINE2		MIXER_WRITE(SOUND_MIXER_LINE2)
252#define SOUND_MIXER_WRITE_LINE3		MIXER_WRITE(SOUND_MIXER_LINE3)
253
254#define SOUND_MASK_VOLUME	(1 << SOUND_MIXER_VOLUME)
255#define SOUND_MASK_BASS		(1 << SOUND_MIXER_BASS)
256#define SOUND_MASK_TREBLE	(1 << SOUND_MIXER_TREBLE)
257#define SOUND_MASK_SYNTH	(1 << SOUND_MIXER_SYNTH)
258#define SOUND_MASK_PCM		(1 << SOUND_MIXER_PCM)
259#define SOUND_MASK_SPEAKER	(1 << SOUND_MIXER_SPEAKER)
260#define SOUND_MASK_LINE		(1 << SOUND_MIXER_LINE)
261#define SOUND_MASK_MIC		(1 << SOUND_MIXER_MIC)
262#define SOUND_MASK_CD		(1 << SOUND_MIXER_CD)
263#define SOUND_MASK_IMIX		(1 << SOUND_MIXER_IMIX)
264#define SOUND_MASK_ALTPCM	(1 << SOUND_MIXER_ALTPCM)
265#define SOUND_MASK_RECLEV	(1 << SOUND_MIXER_RECLEV)
266#define SOUND_MASK_IGAIN	(1 << SOUND_MIXER_IGAIN)
267#define SOUND_MASK_OGAIN	(1 << SOUND_MIXER_OGAIN)
268#define SOUND_MASK_LINE1	(1 << SOUND_MIXER_LINE1)
269#define SOUND_MASK_LINE2	(1 << SOUND_MIXER_LINE2)
270#define SOUND_MASK_LINE3	(1 << SOUND_MIXER_LINE3)
271
272typedef struct mixer_info {
273	char id[16];
274	char name[32];
275	int  modify_counter;
276	int  fillers[10];
277} mixer_info;
278
279typedef struct _old_mixer_info {
280	char id[16];
281	char name[32];
282} _old_mixer_info;
283
284#define SOUND_MIXER_INFO		_IOR ('M', 101, mixer_info)
285#define SOUND_OLD_MIXER_INFO		_IOR ('M', 101, _old_mixer_info)
286
287#define OSS_GETVERSION			_IOR ('M', 118, int)
288
289typedef struct audio_buf_info {
290	int fragments;
291	int fragstotal;
292	int fragsize;
293	int bytes;
294} audio_buf_info;
295
296typedef struct count_info {
297	int bytes;
298	int blocks;
299	int ptr;
300} count_info;
301
302typedef struct buffmem_desc {
303	unsigned int *buffer;
304	int size;
305} buffmem_desc;
306
307#if 0
308/* This is what we'd like to have, but it causes prototype conflicts. */
309#define ioctl _oss_ioctl
310#else
311#define ioctl(x,y,z) _oss_ioctl(x,y,z)
312#endif
313
314#include <sys/cdefs.h>
315
316__BEGIN_DECLS
317int _oss_ioctl(int fd, unsigned long com, void *argp);
318__END_DECLS
319
320#endif /* !_SOUNDCARD_H_ */
321