xt_audio_dev.h

浏览该文件的文档.

 
#ifndef __XT_AUDIO_DEV_H__
#define __XT_AUDIO_DEV_H__
 
/* ==================== [Includes] ========================================== */
 
#include "xt_audio_types.h"
#include "xt_audio_dev_drv.h"
 
#ifdef __cplusplus
extern "C" {
#endif

 
/* ==================== [Defines] =========================================== */
 
/* ==================== [Typedefs] ========================================== */

enum xt_audio_dev_evt {
    XT_AUDIO_DEV_EVT_NO_ERR,            
    XT_AUDIO_DEV_EVT_WRITE_BATCH,       
    XT_AUDIO_DEV_EVT_WRITE_ERROR,       
    XT_AUDIO_DEV_EVT_WRITE_UNDERRUN,    
    XT_AUDIO_DEV_EVT_READ_BATCH,        
    XT_AUDIO_DEV_EVT_READ_READY,        
    XT_AUDIO_DEV_EVT_READ_ERROR,        
};

struct xt_audio_dev_cb_info {
    void *user_data;        
    uint8_t *data;          
    uint32_t size;          
};

typedef void (*xt_audio_dev_evt_cb_t)(xt_audio_t hdl, enum xt_audio_dev_evt evt,
                                      struct xt_audio_dev_cb_info *info);

struct xt_audio_dev_info {
    xt_audio_dev_evt_cb_t user_cb;  
    void *user_data;                
    uint8_t level;                  
};

struct xt_audio_dev_config {
    const char *drv_name;           
    xt_audio_mode_t mode;           
    uint16_t sample_freq;           
    uint8_t sample_bits;            
    uint8_t channel_num;            
    uint16_t frame_size;            
    uint8_t write_wq_num;           
    uint8_t read_wq_num;            
    xt_audio_dev_evt_cb_t evt_cb;   
    void *evt_cb_user_data;         
};
 
/* ==================== [Global Prototypes] ================================= */

xt_err_t xt_audio_dev_setup(struct xt_audio_dev_config *cfg, xt_audio_t *hdl);

xt_err_t xt_audio_dev_close(xt_audio_t hdl);

xt_err_t xt_audio_dev_stop_ext(xt_audio_t hdl, xt_audio_mode_t mode);
 
#define xt_audio_dev_stop(_hdl) xt_audio_dev_stop_ext(_hdl, (xt_audio_mode_t)-1)
#define xt_audio_dev_read_stop(_hdl) xt_audio_dev_stop_ext(_hdl, XT_AUDIO_MODE_READ)

int xt_audio_dev_write_ext(xt_audio_t hdl, uint8_t *data, uint32_t size, struct xt_audio_dev_info *info);
 
#define xt_audio_dev_write(_hdl, _data, _size, _level)     \
    xt_audio_dev_write_ext(_hdl, _data, _size, &((struct xt_audio_dev_info){.level = _level}))

int xt_audio_dev_read_ext(xt_audio_t hdl, uint8_t *data, uint32_t size, struct xt_audio_dev_info *info);

int xt_audio_dev_read_start_ext(xt_audio_t hdl, struct xt_audio_dev_info *info);
 
#define xt_audio_dev_read(_hdl, _data, _size, _level)     \
    xt_audio_dev_read_ext(_hdl, _data, _size, &((struct xt_audio_dev_info){.level = _level}))

xt_err_t xt_audio_dev_get_format(xt_audio_t hdl, struct xt_audio_format *fmt);

uint16_t xt_audio_dev_get_frame_interval(xt_audio_t hdl);

xt_err_t xt_audio_dev_sleep(xt_audio_t hdl);

xt_err_t xt_audio_dev_resume(xt_audio_t hdl);

xt_err_t xt_audio_dev_register_drv(struct xt_audio_dev_drv *drv);

struct xt_audio_dev_drv *xt_audio_dev_get_drv(const char *name);
 
/* ==================== [Macros] ============================================ */
  /* xt_audio_dev */
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* __XT_AUDIO_DEV_H__ */