audio_probe_snapshot.hpp

Go to the documentation of this file.

#pragma once

 
#include <cstdint>
#include <type_traits>
 
namespace pulp::audio {

enum class AudioProbeStage : std::uint32_t {
    kUnknown = 0,
    kProcessorOutput = 1,
    kStandaloneOutputBoundary = 2,
    kMeterBridge = 3,
    kDeviceCallback = 4,
    kGraphNode = 5,
};

struct AudioProbeSnapshot {
    static constexpr int kMaxChannels = 32;
 
    // ── Identity tuple (stale/mismatch detection) ──────────────────────────
    double sample_rate = 0.0;
    std::uint32_t block_size = 0;
    std::uint32_t channel_count = 0;
    AudioProbeStage stage_id = AudioProbeStage::kUnknown;
    std::uint64_t sequence_number = 0;
 
    // ── Per-channel scalar metrics (first `channel_count` valid) ────────────
    float peak[kMaxChannels] = {};
    float rms[kMaxChannels] = {};
 
    // ── Aggregate scalar metrics (across active channels, this block) ───────
    float peak_max = 0.0f;
    float rms_max = 0.0f;
 
    // ── Content event counters (cumulative since prepare()) ─────────────────
    std::uint64_t clip_count = 0;
    std::uint64_t nan_inf_count = 0;
    std::uint64_t clipped_blocks = 0;
    std::uint64_t nan_blocks = 0;
    std::uint64_t callbacks = 0;
    std::uint64_t silence_run_blocks = 0;
 
    // ── Drop / overwrite accounting (flight-recorder honesty) ───────────────
    std::uint64_t dropped_capture_frames = 0;
    std::uint64_t overwritten_capture_frames = 0;
};
 
static_assert(std::is_trivially_copyable_v<AudioProbeSnapshot>,
              "AudioProbeSnapshot must be trivially copyable to ride a "
              "TripleBuffer without allocation");
static_assert(std::is_trivially_destructible_v<AudioProbeSnapshot>,
              "AudioProbeSnapshot must be trivially destructible (POD-like)");
 
}  // namespace pulp::audio