1/*
2 * QEMU Audio subsystem header
3 *
4 * Copyright (c) 2003-2005 Vassili Karpov (malc)
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
12 *
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
23 */
24
25#ifndef QEMU_AUDIO_INT_H
26#define QEMU_AUDIO_INT_H
27
28#ifdef CONFIG_AUDIO_COREAUDIO
29#define FLOAT_MIXENG
30/* #define RECIPROCAL */
31#endif
32#include "mixeng.h"
33
34struct audio_pcm_ops;
35
36struct audio_callback {
37 void *opaque;
38 audio_callback_fn fn;
39};
40
41struct audio_pcm_info {
42 int bits;
43 int sign;
44 int freq;
45 int nchannels;
46 int align;
47 int shift;
48 int bytes_per_second;
49 int swap_endianness;
50};
51
52typedef struct AudioState AudioState;
53typedef struct SWVoiceCap SWVoiceCap;
54
55typedef struct HWVoiceOut {
56 AudioState *s;
57 int enabled;
58 int poll_mode;
59 int pending_disable;
60 struct audio_pcm_info info;
61
62 f_sample *clip;
63
64 size_t rpos;
65 uint64_t ts_helper;
66
67 struct st_sample *mix_buf;
68
69 size_t samples;
70 QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head;
71 QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head;
72 int ctl_caps;
73 struct audio_pcm_ops *pcm_ops;
74 QLIST_ENTRY (HWVoiceOut) entries;
75} HWVoiceOut;
76
77typedef struct HWVoiceIn {
78 AudioState *s;
79 int enabled;
80 int poll_mode;
81 struct audio_pcm_info info;
82
83 t_sample *conv;
84
85 size_t wpos;
86 size_t total_samples_captured;
87 uint64_t ts_helper;
88
89 struct st_sample *conv_buf;
90
91 size_t samples;
92 QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head;
93 int ctl_caps;
94 struct audio_pcm_ops *pcm_ops;
95 QLIST_ENTRY (HWVoiceIn) entries;
96} HWVoiceIn;
97
98struct SWVoiceOut {
99 QEMUSoundCard *card;
100 AudioState *s;
101 struct audio_pcm_info info;
102 t_sample *conv;
103 int64_t ratio;
104 struct st_sample *buf;
105 void *rate;
106 size_t total_hw_samples_mixed;
107 int active;
108 int empty;
109 HWVoiceOut *hw;
110 char *name;
111 struct mixeng_volume vol;
112 struct audio_callback callback;
113 QLIST_ENTRY (SWVoiceOut) entries;
114};
115
116struct SWVoiceIn {
117 QEMUSoundCard *card;
118 AudioState *s;
119 int active;
120 struct audio_pcm_info info;
121 int64_t ratio;
122 void *rate;
123 size_t total_hw_samples_acquired;
124 struct st_sample *buf;
125 f_sample *clip;
126 HWVoiceIn *hw;
127 char *name;
128 struct mixeng_volume vol;
129 struct audio_callback callback;
130 QLIST_ENTRY (SWVoiceIn) entries;
131};
132
133typedef struct audio_driver audio_driver;
134struct audio_driver {
135 const char *name;
136 const char *descr;
137 void *(*init) (Audiodev *);
138 void (*fini) (void *);
139 struct audio_pcm_ops *pcm_ops;
140 int can_be_default;
141 int max_voices_out;
142 int max_voices_in;
143 int voice_size_out;
144 int voice_size_in;
145 int ctl_caps;
146 QLIST_ENTRY(audio_driver) next;
147};
148
149struct audio_pcm_ops {
150 int (*init_out)(HWVoiceOut *hw, struct audsettings *as, void *drv_opaque);
151 void (*fini_out)(HWVoiceOut *hw);
152 size_t (*run_out)(HWVoiceOut *hw, size_t live);
153 int (*ctl_out) (HWVoiceOut *hw, int cmd, ...);
154
155 int (*init_in) (HWVoiceIn *hw, struct audsettings *as, void *drv_opaque);
156 void (*fini_in) (HWVoiceIn *hw);
157 size_t (*run_in)(HWVoiceIn *hw);
158 int (*ctl_in) (HWVoiceIn *hw, int cmd, ...);
159};
160
161struct capture_callback {
162 struct audio_capture_ops ops;
163 void *opaque;
164 QLIST_ENTRY (capture_callback) entries;
165};
166
167struct CaptureVoiceOut {
168 HWVoiceOut hw;
169 void *buf;
170 QLIST_HEAD (cb_listhead, capture_callback) cb_head;
171 QLIST_ENTRY (CaptureVoiceOut) entries;
172};
173
174struct SWVoiceCap {
175 SWVoiceOut sw;
176 CaptureVoiceOut *cap;
177 QLIST_ENTRY (SWVoiceCap) entries;
178};
179
180typedef struct AudioState {
181 struct audio_driver *drv;
182 Audiodev *dev;
183 void *drv_opaque;
184
185 QEMUTimer *ts;
186 QLIST_HEAD (card_listhead, QEMUSoundCard) card_head;
187 QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in;
188 QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out;
189 QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head;
190 int nb_hw_voices_out;
191 int nb_hw_voices_in;
192 int vm_running;
193 int64_t period_ticks;
194
195 bool timer_running;
196 uint64_t timer_last;
197
198 QTAILQ_ENTRY(AudioState) list;
199} AudioState;
200
201extern const struct mixeng_volume nominal_volume;
202
203extern const char *audio_prio_list[];
204
205void audio_driver_register(audio_driver *drv);
206audio_driver *audio_driver_lookup(const char *name);
207
208void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as);
209void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
210
211size_t audio_pcm_hw_get_live_in(HWVoiceIn *hw);
212
213size_t audio_pcm_hw_clip_out(HWVoiceOut *hw, void *pcm_buf,
214 size_t live, size_t pending);
215
216int audio_bug (const char *funcname, int cond);
217void *audio_calloc (const char *funcname, int nmemb, size_t size);
218
219void audio_run(AudioState *s, const char *msg);
220
221#define VOICE_ENABLE 1
222#define VOICE_DISABLE 2
223#define VOICE_VOLUME 3
224
225#define VOICE_VOLUME_CAP (1 << VOICE_VOLUME)
226
227static inline size_t audio_ring_dist(size_t dst, size_t src, size_t len)
228{
229 return (dst >= src) ? (dst - src) : (len - src + dst);
230}
231
232#define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
233
234#ifdef DEBUG
235#define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
236#else
237#define ldebug(fmt, ...) (void)0
238#endif
239
240#define AUDIO_STRINGIFY_(n) #n
241#define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
242
243typedef struct AudiodevListEntry {
244 Audiodev *dev;
245 QSIMPLEQ_ENTRY(AudiodevListEntry) next;
246} AudiodevListEntry;
247
248typedef QSIMPLEQ_HEAD(, AudiodevListEntry) AudiodevListHead;
249AudiodevListHead audio_handle_legacy_opts(void);
250
251void audio_free_audiodev_list(AudiodevListHead *head);
252
253void audio_create_pdos(Audiodev *dev);
254AudiodevPerDirectionOptions *audio_get_pdo_in(Audiodev *dev);
255AudiodevPerDirectionOptions *audio_get_pdo_out(Audiodev *dev);
256
257#endif /* QEMU_AUDIO_INT_H */
258