mirror of
https://gitlab.com/qemu-project/qemu
synced 2024-09-06 18:05:37 +00:00
![Kővágó, Zoltán](/assets/img/avatar_default.png)
This will make it possible to skip mixeng with audio playback and recording, allowing us to free ourselves from the limitations of the current mixeng (stereo, int64 samples only). In this case, HW and SW voices will be essentially the same, for every SW voice we will create a HW voice, since we can no longer mix multiple voices together. Some backends expect us to call a function when we have data ready write()/read() style, while others provide a buffer and expects us to directly write/read it, so for optimal performance audio_pcm_ops provide methods for both cases. Previously backends asked mixeng for more data in run_out/run_it, now instead mixeng or the frontends will call the backends, so that's why two sets of functions required. audio.c contains glue code between the two styles, so backends only ever have to implement one style and frontends are free to call whichever is more convenient for them. Signed-off-by: Kővágó, Zoltán <DirtY.iCE.hu@gmail.com> Message-id: 15a33c03a62228922d851f7324c52f73cb8d2414.1568927990.git.DirtY.iCE.hu@gmail.com Signed-off-by: Gerd Hoffmann <kraxel@redhat.com>
287 lines
8 KiB
C
287 lines
8 KiB
C
/*
|
|
* QEMU Audio subsystem header
|
|
*
|
|
* Copyright (c) 2003-2005 Vassili Karpov (malc)
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef QEMU_AUDIO_INT_H
|
|
#define QEMU_AUDIO_INT_H
|
|
|
|
#ifdef CONFIG_AUDIO_COREAUDIO
|
|
#define FLOAT_MIXENG
|
|
/* #define RECIPROCAL */
|
|
#endif
|
|
#include "mixeng.h"
|
|
|
|
struct audio_pcm_ops;
|
|
|
|
struct audio_callback {
|
|
void *opaque;
|
|
audio_callback_fn fn;
|
|
};
|
|
|
|
struct audio_pcm_info {
|
|
int bits;
|
|
int sign;
|
|
int freq;
|
|
int nchannels;
|
|
int align;
|
|
int shift;
|
|
int bytes_per_second;
|
|
int swap_endianness;
|
|
};
|
|
|
|
typedef struct AudioState AudioState;
|
|
typedef struct SWVoiceCap SWVoiceCap;
|
|
|
|
typedef struct HWVoiceOut {
|
|
AudioState *s;
|
|
int enabled;
|
|
int poll_mode;
|
|
int pending_disable;
|
|
struct audio_pcm_info info;
|
|
|
|
f_sample *clip;
|
|
|
|
size_t rpos;
|
|
uint64_t ts_helper;
|
|
|
|
struct st_sample *mix_buf;
|
|
void *buf_emul;
|
|
size_t pos_emul, pending_emul, size_emul;
|
|
|
|
size_t samples;
|
|
QLIST_HEAD (sw_out_listhead, SWVoiceOut) sw_head;
|
|
QLIST_HEAD (sw_cap_listhead, SWVoiceCap) cap_head;
|
|
int ctl_caps;
|
|
struct audio_pcm_ops *pcm_ops;
|
|
QLIST_ENTRY (HWVoiceOut) entries;
|
|
} HWVoiceOut;
|
|
|
|
typedef struct HWVoiceIn {
|
|
AudioState *s;
|
|
int enabled;
|
|
int poll_mode;
|
|
struct audio_pcm_info info;
|
|
|
|
t_sample *conv;
|
|
|
|
size_t wpos;
|
|
size_t total_samples_captured;
|
|
uint64_t ts_helper;
|
|
|
|
struct st_sample *conv_buf;
|
|
void *buf_emul;
|
|
size_t pos_emul, pending_emul, size_emul;
|
|
|
|
size_t samples;
|
|
QLIST_HEAD (sw_in_listhead, SWVoiceIn) sw_head;
|
|
int ctl_caps;
|
|
struct audio_pcm_ops *pcm_ops;
|
|
QLIST_ENTRY (HWVoiceIn) entries;
|
|
} HWVoiceIn;
|
|
|
|
struct SWVoiceOut {
|
|
QEMUSoundCard *card;
|
|
AudioState *s;
|
|
struct audio_pcm_info info;
|
|
t_sample *conv;
|
|
int64_t ratio;
|
|
struct st_sample *buf;
|
|
void *rate;
|
|
size_t total_hw_samples_mixed;
|
|
int active;
|
|
int empty;
|
|
HWVoiceOut *hw;
|
|
char *name;
|
|
struct mixeng_volume vol;
|
|
struct audio_callback callback;
|
|
QLIST_ENTRY (SWVoiceOut) entries;
|
|
};
|
|
|
|
struct SWVoiceIn {
|
|
QEMUSoundCard *card;
|
|
AudioState *s;
|
|
int active;
|
|
struct audio_pcm_info info;
|
|
int64_t ratio;
|
|
void *rate;
|
|
size_t total_hw_samples_acquired;
|
|
struct st_sample *buf;
|
|
f_sample *clip;
|
|
HWVoiceIn *hw;
|
|
char *name;
|
|
struct mixeng_volume vol;
|
|
struct audio_callback callback;
|
|
QLIST_ENTRY (SWVoiceIn) entries;
|
|
};
|
|
|
|
typedef struct audio_driver audio_driver;
|
|
struct audio_driver {
|
|
const char *name;
|
|
const char *descr;
|
|
void *(*init) (Audiodev *);
|
|
void (*fini) (void *);
|
|
struct audio_pcm_ops *pcm_ops;
|
|
int can_be_default;
|
|
int max_voices_out;
|
|
int max_voices_in;
|
|
int voice_size_out;
|
|
int voice_size_in;
|
|
int ctl_caps;
|
|
QLIST_ENTRY(audio_driver) next;
|
|
};
|
|
|
|
struct audio_pcm_ops {
|
|
int (*init_out)(HWVoiceOut *hw, audsettings *as, void *drv_opaque);
|
|
void (*fini_out)(HWVoiceOut *hw);
|
|
size_t (*run_out)(HWVoiceOut *hw, size_t live);
|
|
size_t (*write) (HWVoiceOut *hw, void *buf, size_t size);
|
|
/*
|
|
* get a buffer that after later can be passed to put_buffer_out; optional
|
|
* returns the buffer, and writes it's size to size (in bytes)
|
|
* this is unrelated to the above buffer_size_out function
|
|
*/
|
|
void *(*get_buffer_out)(HWVoiceOut *hw, size_t *size);
|
|
/*
|
|
* put back the buffer returned by get_buffer_out; optional
|
|
* buf must be equal the pointer returned by get_buffer_out,
|
|
* size may be smaller
|
|
*/
|
|
size_t (*put_buffer_out)(HWVoiceOut *hw, void *buf, size_t size);
|
|
int (*ctl_out) (HWVoiceOut *hw, int cmd, ...);
|
|
|
|
int (*init_in) (HWVoiceIn *hw, audsettings *as, void *drv_opaque);
|
|
void (*fini_in) (HWVoiceIn *hw);
|
|
size_t (*run_in)(HWVoiceIn *hw);
|
|
size_t (*read) (HWVoiceIn *hw, void *buf, size_t size);
|
|
void *(*get_buffer_in)(HWVoiceIn *hw, size_t *size);
|
|
void (*put_buffer_in)(HWVoiceIn *hw, void *buf, size_t size);
|
|
int (*ctl_in) (HWVoiceIn *hw, int cmd, ...);
|
|
};
|
|
|
|
void *audio_generic_get_buffer_in(HWVoiceIn *hw, size_t *size);
|
|
void audio_generic_put_buffer_in(HWVoiceIn *hw, void *buf, size_t size);
|
|
void *audio_generic_get_buffer_out(HWVoiceOut *hw, size_t *size);
|
|
size_t audio_generic_put_buffer_out(HWVoiceOut *hw, void *buf, size_t size);
|
|
size_t audio_generic_put_buffer_out_nowrite(HWVoiceOut *hw, void *buf,
|
|
size_t size);
|
|
size_t audio_generic_write(HWVoiceOut *hw, void *buf, size_t size);
|
|
size_t audio_generic_read(HWVoiceIn *hw, void *buf, size_t size);
|
|
|
|
struct capture_callback {
|
|
struct audio_capture_ops ops;
|
|
void *opaque;
|
|
QLIST_ENTRY (capture_callback) entries;
|
|
};
|
|
|
|
struct CaptureVoiceOut {
|
|
HWVoiceOut hw;
|
|
void *buf;
|
|
QLIST_HEAD (cb_listhead, capture_callback) cb_head;
|
|
QLIST_ENTRY (CaptureVoiceOut) entries;
|
|
};
|
|
|
|
struct SWVoiceCap {
|
|
SWVoiceOut sw;
|
|
CaptureVoiceOut *cap;
|
|
QLIST_ENTRY (SWVoiceCap) entries;
|
|
};
|
|
|
|
typedef struct AudioState {
|
|
struct audio_driver *drv;
|
|
Audiodev *dev;
|
|
void *drv_opaque;
|
|
|
|
QEMUTimer *ts;
|
|
QLIST_HEAD (card_listhead, QEMUSoundCard) card_head;
|
|
QLIST_HEAD (hw_in_listhead, HWVoiceIn) hw_head_in;
|
|
QLIST_HEAD (hw_out_listhead, HWVoiceOut) hw_head_out;
|
|
QLIST_HEAD (cap_listhead, CaptureVoiceOut) cap_head;
|
|
int nb_hw_voices_out;
|
|
int nb_hw_voices_in;
|
|
int vm_running;
|
|
int64_t period_ticks;
|
|
|
|
bool timer_running;
|
|
uint64_t timer_last;
|
|
|
|
QTAILQ_ENTRY(AudioState) list;
|
|
} AudioState;
|
|
|
|
extern const struct mixeng_volume nominal_volume;
|
|
|
|
extern const char *audio_prio_list[];
|
|
|
|
void audio_driver_register(audio_driver *drv);
|
|
audio_driver *audio_driver_lookup(const char *name);
|
|
|
|
void audio_pcm_init_info (struct audio_pcm_info *info, struct audsettings *as);
|
|
void audio_pcm_info_clear_buf (struct audio_pcm_info *info, void *buf, int len);
|
|
|
|
size_t audio_pcm_hw_get_live_in(HWVoiceIn *hw);
|
|
|
|
size_t audio_pcm_hw_clip_out(HWVoiceOut *hw, void *pcm_buf,
|
|
size_t live, size_t pending);
|
|
|
|
int audio_bug (const char *funcname, int cond);
|
|
void *audio_calloc (const char *funcname, int nmemb, size_t size);
|
|
|
|
void audio_run(AudioState *s, const char *msg);
|
|
|
|
#define VOICE_ENABLE 1
|
|
#define VOICE_DISABLE 2
|
|
#define VOICE_VOLUME 3
|
|
|
|
#define VOICE_VOLUME_CAP (1 << VOICE_VOLUME)
|
|
|
|
static inline size_t audio_ring_dist(size_t dst, size_t src, size_t len)
|
|
{
|
|
return (dst >= src) ? (dst - src) : (len - src + dst);
|
|
}
|
|
|
|
#define dolog(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
|
|
|
|
#ifdef DEBUG
|
|
#define ldebug(fmt, ...) AUD_log(AUDIO_CAP, fmt, ## __VA_ARGS__)
|
|
#else
|
|
#define ldebug(fmt, ...) (void)0
|
|
#endif
|
|
|
|
#define AUDIO_STRINGIFY_(n) #n
|
|
#define AUDIO_STRINGIFY(n) AUDIO_STRINGIFY_(n)
|
|
|
|
typedef struct AudiodevListEntry {
|
|
Audiodev *dev;
|
|
QSIMPLEQ_ENTRY(AudiodevListEntry) next;
|
|
} AudiodevListEntry;
|
|
|
|
typedef QSIMPLEQ_HEAD(, AudiodevListEntry) AudiodevListHead;
|
|
AudiodevListHead audio_handle_legacy_opts(void);
|
|
|
|
void audio_free_audiodev_list(AudiodevListHead *head);
|
|
|
|
void audio_create_pdos(Audiodev *dev);
|
|
AudiodevPerDirectionOptions *audio_get_pdo_in(Audiodev *dev);
|
|
AudiodevPerDirectionOptions *audio_get_pdo_out(Audiodev *dev);
|
|
|
|
#endif /* QEMU_AUDIO_INT_H */
|