一、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() ；