audio/audio_int.h

   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
  34 struct audio_pcm_ops;
  35
  36 struct audio_callback {
  37     void *opaque;
  38     audio_callback_fn fn;
  39 };
  40
  41 struct 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
  52 typedef struct AudioState AudioState;
  53 typedef struct SWVoiceCap SWVoiceCap;
  54
  55 typedef 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
  77 typedef 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
  98 struct 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
 116 struct 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
 133 typedef struct audio_driver audio_driver;
 134 struct 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
 149 struct 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
 161 struct capture_callback {
 162     struct audio_capture_ops ops;
 163     void *opaque;
 164     QLIST_ENTRY (capture_callback) entries;
 165 };
 166
 167 struct CaptureVoiceOut {
 168     HWVoiceOut hw;
 169     void *buf;
 170     QLIST_HEAD (cb_listhead, capture_callback) cb_head;
 171     QLIST_ENTRY (CaptureVoiceOut) entries;
 172 };
 173
 174 struct SWVoiceCap {
 175     SWVoiceOut sw;
 176     CaptureVoiceOut *cap;
 177     QLIST_ENTRY (SWVoiceCap) entries;
 178 };
 179
 180 typedef 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
 201 extern const struct mixeng_volume nominal_volume;
 202
 203 extern const char *audio_prio_list[];
 204
 205 void audio_driver_register(audio_driver *drv);
 206 audio_driver *audio_driver_lookup(const char *name);
 207
 208 void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as);
 209 void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
 210
 211 size_t audio_pcm_hw_get_live_in(HWVoiceIn *hw);
 212
 213 size_t audio_pcm_hw_clip_out(HWVoiceOut *hw, void *pcm_buf,
 214                              size_t live, size_t pending);
 215
 216 int audio_bug (const char *funcname, int cond);
 217 void *audio_calloc (const char *funcname, int nmemb, size_t size);
 218
 219 void 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
 227 static 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
 243 typedef struct AudiodevListEntry {
 244     Audiodev *dev;
 245     QSIMPLEQ_ENTRY(AudiodevListEntry) next;
 246 } AudiodevListEntry;
 247
 248 typedef QSIMPLEQ_HEAD(, AudiodevListEntry) AudiodevListHead;
 249 AudiodevListHead audio_handle_legacy_opts(void);
 250
 251 void audio_free_audiodev_list(AudiodevListHead *head);
 252
 253 void audio_create_pdos(Audiodev *dev);
 254 AudiodevPerDirectionOptions *audio_get_pdo_in(Audiodev *dev);
 255 AudiodevPerDirectionOptions *audio_get_pdo_out(Audiodev *dev);
 256
 257 #endif /* QEMU_AUDIO_INT_H */