xt_audio_dev_drv.h

浏览该文件的文档.

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

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

enum xt_audio_dev_sw_cmd {
    XT_AUDIO_DEV_SW_ON,
    XT_AUDIO_DEV_SW_OFF,
};

struct xt_audio_dev_sw_desc {
    void (*cb)(enum xt_audio_dev_sw_cmd cmd, void *arg);
    void *cb_arg;
    uint8_t io;                 
    uint8_t active_level;       
    uint16_t on_delay_ms;       
    uint16_t off_delay_ms;      
};

enum xt_audio_dev_drv_evt {
    XT_AUDIO_DEV_DRV_EVT_TX_IDLE,   /* 写方向 ring buffer 排空 */
    XT_AUDIO_DEV_DRV_EVT_RX_IDLE,   /* 读方向（预留） */
};

typedef void (*xt_audio_dev_drv_cb_t)(int evt, void *user_data);

union xt_audio_dev_ctrl_arg {
    struct { uint8_t val; } set_level;      /* SET_WRITE_LEVEL / SET_READ_LEVEL */
    struct { uint8_t *val; } get_level;     /* GET_WRITE_LEVEL / GET_READ_LEVEL */
    struct { xt_audio_mode_t mode; } active; /* ACTIVE: 触发方向 */
    struct { xt_audio_mode_t mode; } idle;   /* IDLE: 触发方向 */
    struct { uint8_t type; uint16_t val; } param;       /* SET_PARAM / GET_PARAM */
    struct { uint8_t type; uint16_t *list; } param_list; /* SET_PARAM_LIST / GET_PARAM_LIST */
};

enum xt_audio_dev_ctrl_cmd {
    XT_AUDIO_DEV_CTRL_ACTIVE,               /* idle→active */
    XT_AUDIO_DEV_CTRL_IDLE,                 /* active→idle */
    XT_AUDIO_DEV_CTRL_SLEEP,                /* 深休眠 */
    XT_AUDIO_DEV_CTRL_RESUME,               /* 从深休眠恢复 */
    XT_AUDIO_DEV_CTRL_SET_WRITE_LEVEL,      /* 写方向 level */
    XT_AUDIO_DEV_CTRL_SET_READ_LEVEL,       /* 读方向 level */
    XT_AUDIO_DEV_CTRL_GET_WRITE_LEVEL,      /* 获取写方向默认 level */
    XT_AUDIO_DEV_CTRL_GET_READ_LEVEL,       /* 获取读方向默认 level */
    XT_AUDIO_DEV_CTRL_SET_PARAM,            /* 设置单个参数（调试用） */
    XT_AUDIO_DEV_CTRL_GET_PARAM,            /* 获取单个参数 */
    XT_AUDIO_DEV_CTRL_SET_PARAM_LIST,       /* 设置参数等级列表 */
    XT_AUDIO_DEV_CTRL_GET_PARAM_LIST,       /* 获取参数等级列表 */
};

struct xt_audio_dev_ops {
    xt_err_t (*open)(void *ctx, struct xt_audio_format *fmt, xt_audio_dev_drv_cb_t cb, void *cb_ctx);
    xt_err_t (*close)(void *ctx);
    int (*write)(void *ctx, uint8_t *data, uint32_t size);   /* 正数=实际写入量, 负数=错误码 */
    int (*read)(void *ctx, uint8_t *data, uint32_t size);    /* 正数=实际读取量, 负数=错误码 */
    xt_err_t (*ctrl)(void *ctx, int cmd, union xt_audio_dev_ctrl_arg *arg);
};

struct xt_audio_dev_drv {
    const char *name;               
    struct xt_audio_dev_ops *ops;
    void *ctx;                      
};
 
/* ==================== [Global Prototypes] ================================= */

xt_err_t xt_audio_dev_register_drv(struct xt_audio_dev_drv *drv);
 
/* ==================== [Macros] ============================================ */
  /* xt_audio_dev_drv */
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* __XT_AUDIO_DEV_DRV_H__ */