audio.h

Go to the documentation of this file.

/* SPDX-License-Identifier: GPL-3.0-or-later */
 
#ifndef OVE_AUDIO_H
#define OVE_AUDIO_H
 
#include "ove/audio_node.h"
#include "ove/storage.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#ifdef CONFIG_OVE_AUDIO
 
/* ── Graph limits ───────────────────────────────────────────────── */
 
#define OVE_AUDIO_GRAPH_MAX_NODES 16
#define OVE_AUDIO_GRAPH_MAX_EDGES 16
 
/* ── Edge ───────────────────────────────────────────────────────── */
 
struct ove_audio_edge {
    unsigned int from; 
    unsigned int to;   
};
 
/* ── Diagnostics ────────────────────────────────────────────────── */
 
struct ove_audio_graph_stats {
    unsigned int cycles;         
    unsigned int underruns;      
    unsigned int overruns;       
    unsigned int node_errors;    
    unsigned int max_process_us; 
    unsigned int
        avg_process_us; 
};
 
/* ── Graph ──────────────────────────────────────────────────────── */
 
enum ove_audio_graph_state {
    OVE_AUDIO_GRAPH_IDLE,    
    OVE_AUDIO_GRAPH_READY,   
    OVE_AUDIO_GRAPH_RUNNING, 
};
 
struct ove_audio_graph {
    struct ove_audio_node
        nodes[OVE_AUDIO_GRAPH_MAX_NODES]; 
    unsigned int node_count; 
    struct ove_audio_edge
        edges[OVE_AUDIO_GRAPH_MAX_EDGES]; 
    unsigned int edge_count; 
    unsigned int exec_order
        [OVE_AUDIO_GRAPH_MAX_NODES]; 
    unsigned int exec_count; 
    struct ove_audio_buf
        buffers[OVE_AUDIO_GRAPH_MAX_NODES]; 
    void *buf_storage;   
    size_t buf_storage_size; 
    unsigned int frames_per_period;   
    enum ove_audio_graph_state state; 
    struct ove_audio_graph_stats stats; 
};
 
/* ── Graph API ──────────────────────────────────────────────────── */
 
int ove_audio_graph_init(struct ove_audio_graph *g, unsigned int frames_per_period);
 
void ove_audio_graph_deinit(struct ove_audio_graph *g);
 
int ove_audio_graph_add_node(struct ove_audio_graph *g, const struct ove_audio_node_ops *ops,
                 void *ctx, const char *name, enum ove_audio_node_type type);
 
int ove_audio_graph_connect(struct ove_audio_graph *g, unsigned int from, unsigned int to);
 
int ove_audio_graph_set_buf_storage(struct ove_audio_graph *g, void *storage, size_t size);
 
#define OVE_AUDIO_GRAPH_STORAGE_BYTES(nodes, frames, channels, sample_bytes) \
    ((size_t)(nodes) * (size_t)(frames) * (size_t)(channels) * (size_t)(sample_bytes))
 
/* ── _create / _destroy — heap-mode only (gated by OVE_HEAP_AUDIO) ───── */
#ifdef OVE_HEAP_AUDIO
 
int ove_audio_graph_create_(struct ove_audio_graph *g, unsigned int frames);
 
int ove_audio_graph_destroy(struct ove_audio_graph *g);
 
#define ove_audio_graph_create(pg, frames, nodes, channels, sample_bytes) \
    ((void)(nodes), (void)(channels), (void)(sample_bytes),           \
     ove_audio_graph_create_((pg), (frames)))
 
#endif /* OVE_HEAP_AUDIO */
 
#define OVE_AUDIO_GRAPH_DEFINE(name, nodes, frames, channels, sample_bytes)                  \
    static uint8_t name##_buf[OVE_AUDIO_GRAPH_STORAGE_BYTES(                             \
        (nodes), (frames), (channels), (sample_bytes))] __attribute__((aligned(4))); \
    static struct ove_audio_graph name
 
int ove_audio_graph_build(struct ove_audio_graph *g);
 
int ove_audio_graph_start(struct ove_audio_graph *g);
 
int ove_audio_graph_stop(struct ove_audio_graph *g);
 
int ove_audio_graph_process(struct ove_audio_graph *g);
 
int ove_audio_graph_get_stats(const struct ove_audio_graph *g, struct ove_audio_graph_stats *stats);
 
#else /* !CONFIG_OVE_AUDIO */
 
struct ove_audio_graph {
    int _unused;
};
 
static inline int ove_audio_graph_init(struct ove_audio_graph *g, unsigned int f)
{
    (void)g;
    (void)f;
    return -5; /* OVE_ERR_NOT_SUPPORTED */
}
static inline void ove_audio_graph_deinit(struct ove_audio_graph *g)
{
    (void)g;
}
 
#endif /* CONFIG_OVE_AUDIO */
 
#ifdef __cplusplus
}
#endif
 
 
#endif /* OVE_AUDIO_H */