[client] audio: harden low-latency streaming

Rework audio provider and backend lifecycles so playback and capture
callbacks quiesce without blocking real-time threads. Move activation,
teardown, controls, retries, and diagnostics onto bounded workers.

Harden USB audio cadence, feedback, and capture recovery.
Preserve source clocks through recording and pace packets from the
device clock. Bound queues, waits, conversion buffers, and packet sizes.

Make PipeWire and PulseAudio stream control thread-safe and recoverable.
Correct latency clock domains, coalesce rate updates, preserve recent
capture under overload, and keep logging outside real-time callbacks.
This commit is contained in:
Geoffrey McRae
2026-08-10 16:36:12 +10:00
parent 4434985aa3
commit 87aa61510c
13 changed files with 4795 additions and 1217 deletions

View File

@@ -21,6 +21,7 @@
#ifndef _H_LG_CLIENT_USB_AUDIO_
#define _H_LG_CLIENT_USB_AUDIO_
#include "interface/audio.h"
#include "usbredir.h"
#include <stddef.h>
@@ -49,21 +50,25 @@ typedef struct LG_USBAudioEventOps
LG_USBAudioEventOps;
LG_USBAudio * lgUsbAudio_create(
const LG_USBAudioEventOps * events, void * eventOpaque);
const LG_USBAudioEventOps * events, void * eventOpaque, bool debug);
/* Destroy the LG_USBRedir using this device before destroying the device. */
void lgUsbAudio_destroy(LG_USBAudio * audio);
/* Publish the requested source rate without touching usbredir from the audio
* feedback thread. */
void lgUsbAudio_setFeedbackRate(LG_USBAudio * audio, double sampleRate);
bool lgUsbAudio_feedbackActive(const LG_USBAudio * audio);
/* Queue interleaved packed signed 24-bit microphone frames. This may be
* called from the audio recording thread. */
/* Queue interleaved packed signed 24-bit microphone frames. sourceClock is
* borrowed for the call and identifies the first frame when present. This may
* be called from the audio recording thread. */
bool lgUsbAudio_recordData(
LG_USBAudio * audio, const void * data, size_t frames);
LG_USBAudio * audio, const void * data, size_t frames,
const LG_AudioClock * sourceClock);
/* This must be queried on the PureSpice processing thread. */
bool lgUsbAudio_recording(const LG_USBAudio * audio);
/* Return the time until ISO-IN processing is needed. This must be queried on
* the PureSpice processing thread. */
uint64_t lgUsbAudio_processDelayNs(const LG_USBAudio * audio);
const LG_USBRedirDeviceOps * lgUsbAudio_deviceOps(void);