322 lines
12 KiB
C
322 lines
12 KiB
C
#ifndef AUDIO_STREAM_H
|
||
#define AUDIO_STREAM_H
|
||
|
||
#include "generic/includes.h"
|
||
#include "media/audio_base.h"
|
||
|
||
|
||
// 数据流IOCTRL命令
|
||
#define AUDIO_STREAM_IOCTRL_CMD_CHECK_ACTIVE (1) // 检查数据流是否活动
|
||
|
||
|
||
struct audio_stream_entry;
|
||
struct audio_frame_copy;
|
||
|
||
|
||
/*
|
||
* 数据流中的传输内容
|
||
*/
|
||
struct audio_data_frame {
|
||
u8 channel; // 通道数
|
||
u16 stop : 1; // 数据流停止标志
|
||
u16 data_sync : 1; // 数据流同步标志
|
||
u16 no_subsequent : 1; // 1-不再执行后续的数据流；0-正常执行
|
||
u32 sample_rate; // 采样率
|
||
u16 offset; // 数据偏移
|
||
u16 data_len; // 数据长度
|
||
s16 *data; // 数据地址
|
||
};
|
||
|
||
|
||
/*
|
||
* 数据流
|
||
* 多个数据流节点组成一个数据流
|
||
*/
|
||
struct audio_stream {
|
||
struct audio_stream_entry *entry; // 数据流节点
|
||
void *priv; // resume私有参数
|
||
void (*resume)(void *priv); // 激活回调接口
|
||
};
|
||
|
||
|
||
/*
|
||
* 数据流群组
|
||
* 用于串联多个数据流，在调用resume/clear等操作时依次处理各个数据流
|
||
* 如数据流stream0最后一个节点是entry0_n，数据流1最后一个节点是entry1_n
|
||
* 把这两个数据流加入到群组test_group中
|
||
* audio_stream_group_add_entry(&test_group, &entry0_n);
|
||
* audio_stream_group_add_entry(&test_group, &entry1_n);
|
||
* 另一个数据流streamX的第一个节点是entryX_0，把群组关联到streamX数据流
|
||
* entryX_0.group = &test_group;
|
||
* 那么调用streamX中的resume就会依次调用stream0和stream1的resume了
|
||
*/
|
||
struct audio_stream_group {
|
||
struct audio_stream_entry *entry; // 数据流节点
|
||
};
|
||
|
||
/*
|
||
* 数据流节点
|
||
* 数据流节点依次串联，数据依次往后传递
|
||
*/
|
||
struct audio_stream_entry {
|
||
u8 pass_by; // 1-同步处理（即往后传的buf就是上层传入的buf）；
|
||
// 0-异步处理（数据存到其他buf再往后传）
|
||
u8 remain; // 1-上次数据没输出完。0-上次数据输出完
|
||
u16 offset; // 同步处理时的数据偏移
|
||
struct audio_stream *stream; // 所属的数据流
|
||
struct audio_stream_entry *input; // 上一个节点
|
||
struct audio_stream_entry *output; // 下一个节点
|
||
struct audio_stream_entry *sibling; // 数据流群组中的数据流节点链表
|
||
struct audio_stream_group *group; // 数据流群组节点
|
||
struct audio_frame_copy *frame_copy; // 数据分支节点
|
||
int (*prob_handler)(struct audio_stream_entry *, struct audio_data_frame *in); // 预处理
|
||
int (*data_handler)(struct audio_stream_entry *, struct audio_data_frame *in,
|
||
struct audio_data_frame *out); // 数据处理
|
||
void (*data_process_len)(struct audio_stream_entry *, int len); // 后级返回使用的数据长度
|
||
void (*data_clear)(struct audio_stream_entry *); // 清除节点数据
|
||
int (*ioctrl)(struct audio_stream_entry *, int cmd, int *param); // 节点IOCTRL
|
||
};
|
||
|
||
/*
|
||
* 数据流分支
|
||
* 支持一传多（分支）功能，内部自动生成struct audio_frame_copy来处理多个分支
|
||
* 有多少个分支就会申请多少个空间，数据分别拷贝到对应分支空间然后往后传递
|
||
*/
|
||
struct audio_frame_copy {
|
||
struct list_head head; // 链表。用于连接各个分支
|
||
struct audio_data_frame frame; // 保存上层的传输内容
|
||
struct audio_stream_entry entry; // 连接上层的节点
|
||
};
|
||
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Open
|
||
* Description: 创建一个数据流
|
||
* Arguments : *priv resume回调的私有参数
|
||
* resume 模块唤醒数据流时的回调函数
|
||
* Return : 数据流句柄
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
struct audio_stream *audio_stream_open(void *priv, void (*resume)(void *priv));
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Add First
|
||
* Description: 添加第一个数据流节点
|
||
* Arguments : *stream 数据流句柄
|
||
* *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : 第一个节点一般为解码输出
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_add_first(struct audio_stream *stream,
|
||
struct audio_stream_entry *entry);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Add Head
|
||
* Description: 将节点插入到数据流的first节点后面
|
||
* Arguments : *stream 数据流句柄
|
||
* *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_add_head(struct audio_stream *stream,
|
||
struct audio_stream_entry *entry);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Add Tail
|
||
* Description: 将节点放到数据流的最后
|
||
* Arguments : *stream 数据流句柄
|
||
* *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_add_tail(struct audio_stream *stream,
|
||
struct audio_stream_entry *entry);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Add Entry
|
||
* Description: 将output节点添加到input节点之后
|
||
* Arguments : *input 数据流节点句柄
|
||
* *output 需要添加的数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : 如果input节点后面已经连接有节点，将创建数据流分支处理
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_add_entry(struct audio_stream_entry *input,
|
||
struct audio_stream_entry *output);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Add List
|
||
* Description: 将entry数组中节点按顺序添加到数据流中
|
||
* Arguments : *stream 数据流句柄
|
||
* *entry[] 数据流节点数组
|
||
* num 节点总个数
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_add_list(struct audio_stream *stream,
|
||
struct audio_stream_entry *entry[], int num);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Delete Entry
|
||
* Description: 将节点从数据流中删除
|
||
* Arguments : *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_del_entry(struct audio_stream_entry *entry);
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Delete List Entry
|
||
* Description: 依次将数组中的节点删除
|
||
* Arguments : *entry[] 数据流节点数组
|
||
* num 节点总个数
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_del_list(struct audio_stream_entry *entry[], int num);
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Group Add Entry
|
||
* Description: 将节点加入到群组之中
|
||
* Arguments : *group 数据流群组句柄
|
||
* *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_group_add_entry(struct audio_stream_group *group,
|
||
struct audio_stream_entry *entry);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Group Delete Entry
|
||
* Description: 将节点从群组之中删除
|
||
* Arguments : *group 数据流群组句柄
|
||
* *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_group_del_entry(struct audio_stream_group *group,
|
||
struct audio_stream_entry *entry);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Group Get Entry Number
|
||
* Description: 获取群组中的节点个数
|
||
* Arguments : *group 数据流群组句柄
|
||
* Return : 节点个数
|
||
* Note(s) : None.
|
||
*********************************************************************
|
||
*/
|
||
int audio_stream_group_entry_num(struct audio_stream_group *group);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Run
|
||
* Description: 数据处理接口
|
||
* Arguments : *entry 数据流节点句柄
|
||
* *input 输入数据
|
||
* Return : 负数-出错
|
||
* Note(s) : 数据流依次递归往后传输。直到最后一个节点，或者no_subsequent==1，
|
||
* 或者prob_handler/data_handler处理错误返回负数
|
||
*********************************************************************
|
||
*/
|
||
int audio_stream_run(struct audio_stream_entry *from, struct audio_data_frame *input);
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Resume
|
||
* Description: 唤醒数据流
|
||
* Arguments : *entry 数据流节点句柄
|
||
* Return : 0-成功
|
||
* Note(s) : 最终会递归调用到struct audio_stream结构体中的.resume回调接口
|
||
*********************************************************************
|
||
*/
|
||
int audio_stream_resume(struct audio_stream_entry *entry);
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Clear From Entry
|
||
* Description: 清除指定节点及后续所有节点的数据
|
||
* Arguments : *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : 会清除offset/pass_by等记录，并且调用data_clear回调接口清除用户数据
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_clear_from(struct audio_stream_entry *entry);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Clear
|
||
* Description: 清除数据流所有节点数据
|
||
* Arguments : *stream 数据流句柄
|
||
* Return : None.
|
||
* Note(s) : 会清除offset/pass_by等记录，并且调用data_clear回调接口清除用户数据
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_clear(struct audio_stream *stream);
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Clear By Entry
|
||
* Description: 通过数据流某个节点清除数据流所有节点数据
|
||
* Arguments : *entry 数据流节点句柄
|
||
* Return : None.
|
||
* Note(s) : 先找到数据流起始位置，再调用audio_stream_clear()清除所有节点
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_clear_by_entry(struct audio_stream_entry *entry);
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Check Active From Entry
|
||
* Description: 检测指定节点及后续节点是否有活动情况
|
||
* Arguments : *entry 数据流节点句柄
|
||
* Return : true 活动
|
||
* Note(s) : 只要中间有某个节点活动就会返回数据流活动
|
||
*********************************************************************
|
||
*/
|
||
int audio_stream_check_active_from(struct audio_stream_entry *entry);
|
||
|
||
|
||
/*
|
||
*********************************************************************
|
||
* Audio Stream Close
|
||
* Description: 关闭数据流
|
||
* Arguments : *stream 数据流句柄
|
||
* Return : None.
|
||
* Note(s) : 需关闭所有数据流节点之后才能调用该函数
|
||
*********************************************************************
|
||
*/
|
||
void audio_stream_close(struct audio_stream *stream);
|
||
|
||
#endif
|
||
|
||
|
||
|
||
|
||
|