1 /*        $NetBSD: ossaudiovar.h,v 1.16 2011/09/06 01:19:34 jmcneill Exp $      */
2 
3 /*-
4  * Copyright (c) 1997 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
17  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
18  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
23  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
24  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
25  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26  * POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 struct oss_sys_ioctl_args {
30           syscallarg(int) fd;
31           syscallarg(u_long) com;
32           syscallarg(void *) data;
33 };
34 
35 #define OSS_IOCPARM_MASK    0xfff           /* parameters must be < 4096 bytes */
36 #define OSS_IOC_VOID        0x00000000      /* no parameters */
37 #define OSS_IOC_IN          0x40000000      /* copy in parameters */
38 #define OSS_IOC_OUT         0x80000000      /* copy out parameters */
39 #define OSS_IOC_INOUT       (OSS_IOC_IN | OSS_IOC_OUT)
40 #define   _OSS_IOCTL(w,x,y,z) ((uint)((w)|(((z)&OSS_IOCPARM_MASK)<<16)|((x)<<8)|(y)))
41 #define _OSS_IO(x,y)        _OSS_IOCTL(OSS_IOC_VOID, x, y, 0)
42 #define _OSS_IOR(x,y,t)     _OSS_IOCTL(OSS_IOC_OUT, x, y, sizeof(t))
43 #define _OSS_IOW(x,y,t)     _OSS_IOCTL(OSS_IOC_IN, x, y, sizeof(t))
44 #define _OSS_IOWR(x,y,t)    _OSS_IOCTL(OSS_IOC_INOUT, x, y, sizeof(t))
45 
46 #define OSS_IOCTL_SIZE(x) (((x) >> 16) & OSS_IOCPARM_MASK)
47 
48 #define   OSS_SNDCTL_DSP_RESET                    _OSS_IO  ('P', 0)
49 #define   OSS_SNDCTL_DSP_SYNC           _OSS_IO  ('P', 1)
50 #define   OSS_SNDCTL_DSP_SPEED                    _OSS_IOWR('P', 2, int)
51 #define   OSS_SOUND_PCM_READ_RATE                 _OSS_IOR ('P', 2, int)
52 #define   OSS_SNDCTL_DSP_STEREO                   _OSS_IOWR('P', 3, int)
53 #define   OSS_SNDCTL_DSP_GETBLKSIZE     _OSS_IOWR('P', 4, int)
54 #define   OSS_SNDCTL_DSP_SETFMT                   _OSS_IOWR('P', 5, int)
55 #define   OSS_SOUND_PCM_READ_BITS                 _OSS_IOR ('P', 5, int)
56 #define   OSS_SNDCTL_DSP_CHANNELS                 _OSS_IOWR('P', 6, int)
57 #define   OSS_SOUND_PCM_READ_CHANNELS   _OSS_IOR ('P', 6, int)
58 #define OSS_SOUND_PCM_WRITE_FILTER      _OSS_IOWR('P', 7, int)
59 #define OSS_SOUND_PCM_READ_FILTER       _OSS_IOR ('P', 7, int)
60 #define   OSS_SNDCTL_DSP_POST           _OSS_IO  ('P', 8)
61 #define OSS_SNDCTL_DSP_SUBDIVIDE        _OSS_IOWR('P', 9, int)
62 #define   OSS_SNDCTL_DSP_SETFRAGMENT    _OSS_IOWR('P', 10, int)
63 #define   OSS_SNDCTL_DSP_GETFMTS                  _OSS_IOR ('P', 11, int)
64 #define OSS_SNDCTL_DSP_GETOSPACE        _OSS_IOR ('P',12, struct oss_audio_buf_info)
65 #define OSS_SNDCTL_DSP_GETISPACE        _OSS_IOR ('P',13, struct oss_audio_buf_info)
66 #define OSS_SNDCTL_DSP_NONBLOCK                   _OSS_IO  ('P',14)
67 #define OSS_SNDCTL_DSP_GETCAPS                    _OSS_IOR ('P',15, int)
68 # define OSS_DSP_CAP_REVISION           0x000000ff
69 # define OSS_DSP_CAP_DUPLEX             0x00000100
70 # define OSS_DSP_CAP_REALTIME           0x00000200
71 # define OSS_DSP_CAP_BATCH              0x00000400
72 # define OSS_DSP_CAP_COPROC             0x00000800
73 # define OSS_DSP_CAP_TRIGGER            0x00001000
74 # define OSS_DSP_CAP_MMAP               0x00002000
75 #define OSS_SNDCTL_DSP_GETTRIGGER       _OSS_IOR ('P', 16, int)
76 #define OSS_SNDCTL_DSP_SETTRIGGER       _OSS_IOW ('P', 16, int)
77 # define OSS_PCM_ENABLE_INPUT           0x00000001
78 # define OSS_PCM_ENABLE_OUTPUT                    0x00000002
79 #define OSS_SNDCTL_DSP_GETIPTR                    _OSS_IOR ('P', 17, struct oss_count_info)
80 #define OSS_SNDCTL_DSP_GETOPTR                    _OSS_IOR ('P', 18, struct oss_count_info)
81 #define OSS_SNDCTL_DSP_MAPINBUF                   _OSS_IOR ('P', 19, struct oss_buffmem_desc)
82 #define OSS_SNDCTL_DSP_MAPOUTBUF        _OSS_IOR ('P', 20, struct oss_buffmem_desc)
83 #define OSS_SNDCTL_DSP_SETSYNCRO        _OSS_IO  ('P', 21)
84 #define OSS_SNDCTL_DSP_SETDUPLEX        _OSS_IO  ('P', 22)
85 #define OSS_SNDCTL_DSP_GETODELAY        _OSS_IOR ('P', 23, int)
86 #define OSS_SNDCTL_DSP_PROFILE                    _OSS_IOW ('P', 23, int)
87 #define     OSS_APF_NORMAL              0         /* Normal applications */
88 #define     OSS_APF_NETWORK             1         /* "external" delays */
89 #define   OSS_APF_CPUINTENS             2         /* CPU delays */
90 
91 #define   OSS_AFMT_QUERY                          0x00000000          /* Return current fmt */
92 #define   OSS_AFMT_MU_LAW                         0x00000001
93 #define   OSS_AFMT_A_LAW                          0x00000002
94 #define   OSS_AFMT_IMA_ADPCM            0x00000004
95 #define   OSS_AFMT_U8                             0x00000008
96 #define   OSS_AFMT_S16_LE                         0x00000010          /* Little endian signed 16 */
97 #define   OSS_AFMT_S16_BE                         0x00000020          /* Big endian signed 16 */
98 #define   OSS_AFMT_S8                             0x00000040
99 #define   OSS_AFMT_U16_LE                         0x00000080          /* Little endian U16 */
100 #define   OSS_AFMT_U16_BE                         0x00000100          /* Big endian U16 */
101 #define   OSS_AFMT_MPEG                           0x00000200          /* MPEG (2) audio */
102 #define   OSS_AFMT_AC3                            0x00000400          /* Dolby Digital AC3 */
103 
104 /* Mixer defines */
105 #define OSS_SOUND_MIXER_FIRST           0
106 #define OSS_SOUND_MIXER_NRDEVICES       17
107 
108 #define OSS_SOUND_MIXER_VOLUME                    0
109 #define OSS_SOUND_MIXER_BASS            1
110 #define OSS_SOUND_MIXER_TREBLE                    2
111 #define OSS_SOUND_MIXER_SYNTH           3
112 #define OSS_SOUND_MIXER_PCM             4
113 #define OSS_SOUND_MIXER_SPEAKER                   5
114 #define OSS_SOUND_MIXER_LINE            6
115 #define OSS_SOUND_MIXER_MIC             7
116 #define OSS_SOUND_MIXER_CD              8
117 #define OSS_SOUND_MIXER_IMIX            9
118 #define OSS_SOUND_MIXER_ALTPCM                    10
119 #define OSS_SOUND_MIXER_RECLEV                    11
120 #define OSS_SOUND_MIXER_IGAIN           12
121 #define OSS_SOUND_MIXER_OGAIN           13
122 #define OSS_SOUND_MIXER_LINE1           14
123 #define OSS_SOUND_MIXER_LINE2           15
124 #define OSS_SOUND_MIXER_LINE3           16
125 
126 #define OSS_SOUND_MIXER_RECSRC                    0xff
127 #define OSS_SOUND_MIXER_DEVMASK                   0xfe
128 #define OSS_SOUND_MIXER_RECMASK                   0xfd
129 #define OSS_SOUND_MIXER_CAPS            0xfc
130 #define  OSS_SOUND_CAP_EXCL_INPUT       1
131 #define OSS_SOUND_MIXER_STEREODEVS      0xfb
132 
133 #define OSS_MIXER_READ(dev)             _OSS_IOR('M', dev, int)
134 
135 #define OSS_SOUND_MIXER_READ_RECSRC     OSS_MIXER_READ(OSS_SOUND_MIXER_RECSRC)
136 #define OSS_SOUND_MIXER_READ_DEVMASK    OSS_MIXER_READ(OSS_SOUND_MIXER_DEVMASK)
137 #define OSS_SOUND_MIXER_READ_RECMASK    OSS_MIXER_READ(OSS_SOUND_MIXER_RECMASK)
138 #define OSS_SOUND_MIXER_READ_STEREODEVS OSS_MIXER_READ(OSS_SOUND_MIXER_STEREODEVS)
139 #define OSS_SOUND_MIXER_READ_CAPS       OSS_MIXER_READ(OSS_SOUND_MIXER_CAPS)
140 
141 #define OSS_MIXER_WRITE(dev)            _OSS_IOW('M', dev, int)
142 #define OSS_MIXER_WRITE_R(dev)                    _OSS_IOWR('M', dev, int)
143 
144 #define OSS_SOUND_MIXER_WRITE_RECSRC    OSS_MIXER_WRITE(OSS_SOUND_MIXER_RECSRC)
145 #define OSS_SOUND_MIXER_WRITE_R_RECSRC  OSS_MIXER_WRITE_R(OSS_SOUND_MIXER_RECSRC)
146 
147 struct oss_mixer_info {
148           char id[16];
149           char name[32];
150           int  modify_counter;
151           int  fillers[10];
152 };
153 
154 struct oss_old_mixer_info {
155           char id[16];
156           char name[32];
157 };
158 
159 #define OSS_SOUND_MIXER_INFO            _OSS_IOR('M', 101, struct oss_mixer_info)
160 #define OSS_SOUND_OLD_MIXER_INFO        _OSS_IOR('M', 101, struct oss_old_mixer_info)
161 
162 #define OSS_SOUND_VERSION   0x030000
163 #define OSS_GET_VERSION                           _OSS_IOR('M', 118, int)
164 
165 #define OSS_GET_DEV(com) ((com) & 0xff)
166 
167 struct oss_audio_buf_info {
168           int fragments;
169           int fragstotal;
170           int fragsize;
171           int bytes;
172 };
173 
174 struct oss_count_info {
175           int bytes;
176           int blocks;
177           int ptr;
178 };
179 
180 struct oss_buffmem_desc {
181           unsigned int *buffer;
182           int size;
183 };
184 
185 /*
186  * MIDI and sequencer I/O.
187  */
188 #define OSS_SEQ_RESET                             _OSS_IO  ('Q', 0)
189 #define OSS_SEQ_SYNC                              _OSS_IO  ('Q', 1)
190 #define OSS_SYNTH_INFO                            _OSS_IOWR('Q', 2, struct oss_synth_info)
191 #define OSS_SEQ_CTRLRATE                _OSS_IOWR('Q', 3, int)
192 #define OSS_SEQ_GETOUTCOUNT             _OSS_IOR ('Q', 4, int)
193 #define OSS_SEQ_GETINCOUNT              _OSS_IOR ('Q', 5, int)
194 #define OSS_SEQ_PERCMODE                _OSS_IOW ('Q', 6, int)
195 #define OSS_SEQ_TESTMIDI                _OSS_IOW ('Q', 8, int)
196 #define OSS_SEQ_RESETSAMPLES            _OSS_IOW ('Q', 9, int)
197 #define OSS_SEQ_NRSYNTHS                _OSS_IOR ('Q',10, int)
198 #define OSS_SEQ_NRMIDIS                           _OSS_IOR ('Q',11, int)
199 #define OSS_MIDI_INFO                             _OSS_IOWR('Q',12, struct oss_midi_info)
200 #define OSS_SEQ_THRESHOLD               _OSS_IOW ('Q',13, int)
201 #define OSS_MEMAVL                      _OSS_IOWR('Q',14, int)
202 #define OSS_FM_4OP_ENABLE               _OSS_IOW ('Q',15, int)
203 #define OSS_SEQ_PANIC                             _OSS_IO  ('Q',17)
204 #define OSS_SEQ_OUTOFBAND               _OSS_IOW ('Q',18, struct oss_seq_event_rec)
205 #define OSS_SEQ_GETTIME                           _OSS_IOR ('Q',19, int)
206 #define OSS_ID                                    _OSS_IOWR('Q',20, struct oss_synth_info)
207 #define OSS_CONTROL                     _OSS_IOWR('Q',21, struct oss_synth_control)
208 #define OSS_REMOVESAMPLE                _OSS_IOWR('Q',22, struct oss_remove_sample)
209 
210 struct oss_synth_control {
211           int devno;          /* Synthesizer # */
212           char data[4000]; /* Device specific command/data record */
213 };
214 
215 struct oss_remove_sample {
216           int devno;          /* Synthesizer # */
217           int bankno;         /* MIDI bank # (0=General MIDI) */
218           int instrno;        /* MIDI instrument number */
219 };
220 
221 struct oss_seq_event_rec {
222           u_char arr[8];
223 };
224 
225 struct oss_synth_info {
226           char      name[30];
227           int       device;
228           int       synth_type;
229 #define OSS_SYNTH_TYPE_FM               0
230 #define OSS_SYNTH_TYPE_SAMPLE           1
231 #define OSS_SYNTH_TYPE_MIDI             2
232 
233           int       synth_subtype;
234 #define OSS_FM_TYPE_ADLIB               0x00
235 #define OSS_FM_TYPE_OPL3                0x01
236 #define OSS_MIDI_TYPE_MPU401            0x401
237 
238 #define OSS_SAMPLE_TYPE_BASIC           0x10
239 #define OSS_SAMPLE_TYPE_GUS             OSS_SAMPLE_TYPE_BASIC
240 
241           int       perc_mode;
242           int       nr_voices;
243           int       nr_drums;
244           int       instr_bank_size;
245           u_int     capabilities;
246 #define OSS_SYNTH_CAP_PERCMODE                    0x00000001
247 #define OSS_SYNTH_CAP_OPL3              0x00000002
248 #define OSS_SYNTH_CAP_INPUT             0x00000004
249           int       _unused[19];
250 };
251 
252 #define OSS_TMR_TIMEBASE                _OSS_IOWR('T', 1, int)
253 #define OSS_TMR_START                             _OSS_IO  ('T', 2)
254 #define OSS_TMR_STOP                              _OSS_IO  ('T', 3)
255 #define OSS_TMR_CONTINUE                _OSS_IO  ('T', 4)
256 #define OSS_TMR_TEMPO                             _OSS_IOWR('T', 5, int)
257 #define OSS_TMR_SOURCE                            _OSS_IOWR('T', 6, int)
258 #  define OSS_TMR_INTERNAL              0x00000001
259 #  define OSS_TMR_EXTERNAL              0x00000002
260 #  define OSS_TMR_MODE_MIDI             0x00000010
261 #  define OSS_TMR_MODE_FSK              0x00000020
262 #  define OSS_TMR_MODE_CLS              0x00000040
263 #  define OSS_TMR_MODE_SMPTE            0x00000080
264 #define OSS_TMR_METRONOME               _OSS_IOW ('T', 7, int)
265 #define OSS_TMR_SELECT                            _OSS_IOW ('T', 8, int)
266 
267