audio.h

/* SPDX-License-Identifier: GPL-3.0-or-later */
 
#ifndef OVE_AUDIO_H
#define OVE_AUDIO_H
 
#include "ove/audio_node.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;                         
    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_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 */