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