首页 > 代码库 > 一、Stream,sink,source,transform

一、Stream,sink,source,transform

1. 蓝牙核心概述

技术分享

2.Stream,sink,source,transform

在ADK的blueCore里面,Stream作为一个逻辑结构用来描述一个数据终点(data Endpoint)。通常,一个流描述一个sink或者source,比如一个UART口,既可以接受数据,也可以发送数据,因此UART-stream包含一个sourse和一个sink。

Data can be written to a sink and read from a source. An application may:

§ Read data from a source and interpret it directly ;

§ Generate data and write it to a sink ;

§ Read data from a source, process it, then write it to a sink  or

§ Connect a source and sink together, so that data arriving at one is automatically transferred to the other.

         Sink有点类似于发送数据缓冲区,Source类比于接收数据缓冲区,它们的特别之处在于:

1、缓冲区驻存于VM内核区,在使用的时候需要映射(sinkMap/sourceMap)到VM用户区才能进行操作。

2、因为是驻存在VM内核去,因此缓冲区数据发生变化(如sink有更多空间可以写入,source有更多数据达到等)时,VM内核可以向已注册的task发送消息。

3、sink与source通常是成对出现的。无论是直接连接还是managed connection,通过连接后,sink与source绑定在一起,通过sink可以查询到对应的source实体,同理,通过source可以找到关联的sink实体。因此部分API只提供sink版本,通常这类API是针对整个连接的,且同一时间,某个sink或者source只能建立一个连接,因此以sink作为入参即可。如:MessageSinkTask(Sink sink, Task task)和MessageSinkGetTask(Sink sink)。

蓝牙例程里面,数据主要以流的形式从一个模块传递到另外一个模块,流封装了(或者说屏蔽了)硬件接口,将物理或者逻辑输入输出模块封装成了流。主要流有:audio(adc,dac,mic等),uart,Rfcomm,Kalimba,File等,一切源于流,一切终于流,跟unix里面一切皆文件有异曲同工之妙。

Streams provide an efficient method of transferring data in BlueLab applications. They can be used to transfer data across the air between connected Bluetooth devices, along a wire between processors in the device or internally on the chip.

通常,每个流都与一个源节点 (source)和一个终节点(sink)关联,所有数据都是产生于源点,终结于sink节点,数据在不同模块之间流动前,需要建立一条逻辑连接(如直接连接StreamConnect(source, sink)),当source节点与sink节点建立连接后,两者绑定在一起,通过一方都可以找到另一方句柄。(有点类似socket建立连接之后,通过getpeername获取对方地址);

         例如,将从uart获取的数据,通过RF发送出去,典型流处理流程如下:

Source = StreamUartSource();

Sink  = StreamRfcommSink();

StreamConnect(Source,  Sink);    /*(直接)连接建立后,数据自动开始从source传递到sink*/

         数据从源节点流向终结点前,这两者必须建立连接,BlueLab提供两种不同的方式来建立连接:

1.Direct connection.直接连接,无需提供控制数据,数据直接从source发送到sink,无需用户干预(对用户透明)。

2.managed connection.用户通过一系列的系统调用建立该类连接,该种连接模式下,用户可以自由控制数据流动,便于拥塞控制等。

         L2CAP,RFCOMM,SCO连接请求成功后都会返回一个sink实体,通过该实体可以所以唯一地访问L2CAP,RFCOMM,SCO链路,这主要是通过sink例程:

uint16 SinkGetScoHandle(Sink sink);

uint16 SinkGetRfcommConnId(Sink sink);

uint16 SinkGetL2capCid(Sink sink)

这些例程实现sink到handler,connid,cid的映射。因此在释放某条链路时的接口:

ConnectionL2capDisconnectRequest(Task theAppTask, Sink sink),入参之一是sink,而不是CID。

更多信息请参考CSR官方文档:CS-207483-UG-ImplementingStreamsinBlueCoreApplicationsUse Guide.pdf

技术分享

 

1.1       音频流

音频主要来源有:PCM,I2S,SPDIF,MIC_L,MIC_R,FM模块,其中PCM,I2S,SPDIF三者由于硬件上共用引脚,因此需要互斥使用。音频数据输出到:PCM,I2S,SPDIF,SPK_L,SPK_R,FM模块。AUDIO_HARDWARE_CODEC是何方神圣呢????

audio_hardware

audio_instance

物理模块

audio_channel

通道号

AUDIO_HARDWARE_PCM

_INSTANCE_0/1

PCM

_CHANNEL_SLOT_x

0,1,2,3

AUDIO_HARDWARE_I2S

_INSTANCE_0/1

I2S

_CHANNEL_SLOT_x

0

AUDIO_HARDWARE_SPDIF

_INSTANCE_0/1

SPDIF

_CHANNEL_SLOT_x

0

AUDIO_HARDWARE_CODEC

_INSTANCE_0/1

SPK_L/R

_CHANNEL_A/B/AB

 

AUDIO_HARDWARE_DIG_MIC

_INSTANCE_0/1/2

MIC_L/R

_CHANNEL_A/B/AB

 

AUDIO_HARDWARE_FM

_INSTANCE_0

FM

_CHANNEL_A/B

 

音频流专有操作接口主要以下三个:

StreamAudioSource();

StreamAudioSink() ;

CodecSetIirFilter() ;

 

一、Stream,sink,source,transform