首页 > 代码库 > 六、GAIA

六、GAIA

1.      GAIA

CSR GAIA (Generic Application Interface Architecture)提供了一个端到端的,与主机无关的生态系统来实现主机应用程序对设备的功能集访问。

1.1       接口实现

         GAIA是处于较上层的应用层协议,其依赖的传输协议有多个,目前ADK支持的传输协议有:RFCOMM,SPP,GATT,不同的传输协议,实现相同的功能,但是在实现这些功能时一些机制和细节又存在着一些差异。因此ADK对传输层定义了多个抽象的接口,这些接口根据当前连接所采取的传输协议而自动映射到该协议对应的接口,具体映射关系如下图所示:

技术分享

 

         当采用不同传输协议时,部分通用接口可能无法找到对应的接口,比如当采用GATT传输协议时,gaiaTransportGetSink()通用接口没有对应的实现接口,因为GATT没有SINK和SOURCE这些实体。

         下面来看看GAIA库和Sink_GAIA的主要结构体和函数接口。Sink_gaia.c主要提供了GAIA可注册事件发生时,向GAIA_Client推送事件的接口,如gaiaReportEvent()等。另外一个主要功能是管理GAIA事务,这主要通过handleGaiaMessage()对外提供的外部钩子函数实现。

 技术分享

 

         Gaia.c提供了GAIA库的大部分功能实现,主要包括以下几个部分:

1.初始化GAIA库,开启GAIA服务器。

2.处理连接,断开连接请求和响应。

3.构建GAIA数据包,应答包,接收并解析GAIA数据包。

4.GAIA模块参数获取和修改接口。

1.2       重要流程

先来看看GAIA如何建立GAIA连接的。连接通常用GAIA_Client通过调用GaiaBtConnectRequest()发起。断开连接的请求可以有个client或者server任何一端发起。

 技术分享

         再来看看GAIA连接建立之后,如何进行GAIA交互的。

 技术分享

         在上图中,上半部分展示了一次典型的GAIA交互——GAIA_Client构造一个GAIA后,通过GAIA传输层发送给对端,GAIA_Server在接收到GAIA命令后,进行解析,如果参数合法,处理该请求后应答该次请求的结果,如果参数有错,则应答错误。

         下半部分展示了GAIA_Client向GAIA_Server注册某个事件,并得到成功应答,在后续时间里,如果该注册的事件发生时,GAIA_Server向GAIA_Client发送notification通知。

         对于到来的GAIA请求,GAIA lib库能够处理少部分请求(比如重启之类),大部分请求需要转发给应用层(sink_gaia.c)进行处理,这中情况下,只需要向应用层发送一条GAIA_UNHANDLED_COMMAND_IND消息即可。

1.3       GAIA Over GATT

下面来看看当传输层采用GATT时,整个流程是怎么样的?

首先,GATT Client和GATT Server都必须支持GATT GAIA Service,GATT Server添加和初始化了GATT GAIA Service。

gaiaGattServerInitialise()->

GaiaStartGattServer()->

gaiaTransportStartGattServer();->

         gaiaTransportGattRegisterServer()->

                   GattManagerRegisterServer(); /*GATT MANAGER Module*/

其次,如果尚未开始GATT连接,则开始GATT连接过程,GATT连接后,在建立的GATT上,通过notify或者indication的方式向BLE_Centural发送消息。

GaiaSendPacket()->

gaiaTransportSendPacket()->

gaiaTransportGattSendPacket()->

                            GattManagerRemoteClientNotify()||GattManagerRemoteClientIndicate();

GaiaBuildAndSendSynch ()->

gaiaTransportGattSend ()->

                   GattManagerRemoteClientNotify()||GattManagerRemoteClientIndicate();

         如何接收来自GATT_Client(BLE_Centural)的数据呢?根据前面GATT部分的了解,那肯定是放在了GAIA GATT库文件里面的内部回调函数里面了。GATT Service在向GATT MANAGER模块注册时指定了该回调函数,在该回调函数里面GATT_MANAGER_SERVER_ACCESS_IND消息提示来自GATT Client的access请求。

gaiaTransportGattRegisterServer()->

         registration_params.task = &gaia->task_data;

message_handler()(gaia->task_data,gaia.c)-> GATT_MANAGER_SERVER_ACCESS_IND

         gaiaHandleGattManagerAccessInd();

六、GAIA