Android的无线接口层(RIL)提供了Android电话服务(android.telephony)与无线电硬件之间的抽象层。RIL是通讯无关的,提供基于GSM的网络支持。
        下图显示了RIL位于Android电话系统架构中的位置:
  
实线框表示Android部分,虚线框表示合作伙伴所专用的部分

RIL包含两个基本部件:
        RIL守护进程(RIL Daemon):RIL守护进程初始化Vendor RIL,管理所有来自Android通讯服务的通讯,将其作为被请求的命令(solicited commands)调度给Vendor RIL。
        Vendor RIL:ril.h文件中的无线电专用Vendor RIL掌管着所有和无线电硬件的通讯,并且通过未被请求的命令(unsolicited commands)分发给RIL 守护进程。

RIL初始化
        Android在启动时初始化通讯栈和Vendor RIL,描述如下:
        1. RIL守护进程读取rild.lib路径和rild.libargs系统参数,决定应该使用的Vendor RIL库和向Vendor RIL提供的初始化参数
        2. RIL守护进程加载Vendor RIL库,执行RIL_Init初始化RIL并为RIL函数获取参数
        3. RIL守护进程调用Android通讯栈中RIL_register,为Vendor RIL函数提供参考。
        RIL守护进程源码请参考:/device/commands/rild/rild.c

RIL 交互:
        RIL句柄提供了两种交互方式:
        主动请求命令(Solicited commands):主动请求命令来自RIL lib,比如DIAL和HANGUP。
        被动请求命令(Unsolicited responses):被动请求命令来自基带,比如CALL_STATE_CHANGED 和 NEW_SMS。
  
主动请求:
        以下代码片段属于主动请求命令
   void OnRequest (int request_id, void *data, size_t datalen, RIL_Token t);
   void OnRequestComplete (RIL_Token t, RIL_Error e, void *response, size_t responselen);
  
   有超过60个主动请求命令:
        * SIM PIN,IO和IMSI/IMEI(11)
        * 电话状态和动作(拨号,应答,静音…)(16)
        * 网络状态查询(4)
        * 网络设置(禁止,转发,选择…)(12)
        * 短信(3)
        * PDP连接(4)
        * 电源和复位(2)
        * 辅助服务(5)
        * 供应商定义及其支持(4)
  
        下图表明了Android系统一个主动请求的电话过程:


被动请求
        以下代码片段属于被动请求命令
   void OnUnsolicitedResponse (int unsolResponse, void *data, size_t datalen);
  
   有超过10条被动请求命令:
        * 网络状态改变(4)
        * 新短信通知(3)
        * 新USSD通知(2)
        * 信号强度和时间改变(2)
  
   下图表明Android系统中一个被动请求的电话过程:

 

实现RIL
   为了实现一个通讯专用RIL,需要执行一系列函数以创建一个共享库,保证Android能够相应无线通信请求。所需要的函数被定义在RIL头部(/include/telephony/ril.h)
   Android通讯接口是通讯无关的,Vendor RIL可以使用任意协议进行无线通讯。Android提供了一个参考Vendor RIL,使用的是贺式(Hayes)AT命令设备,可作为一个商用的快速入门指导以及通讯测试使用。

        RIL参考源码在/commands/reference-ril/。
   通常将你自己的Vendor RIL编译为以下形式:
   libril--.so
   比如:
   libril-acme-124.so
        其中:

        libril:所有vendor RIL的开头;
   :专用公司缩写
   :RIL版本number
   so:文件扩展
  
RIL初始化:
        
特定的Vendor RIL必须定义一个初始化函数,提供一系列句柄函数以处理每一个通讯请求。Android RIL守护进程会在启动时调用RIL_Init以初始化RIL。
        
RIL_RadioFunctions *RIL_Init (RIL_Env* env, int argc, char **argv);
        
RIL_Init 返回一个RIL_RadioFunctions结构体包含无线电函数指针。
type structure {
                        int RIL_version;
                   RIL_RequestFunc onRequest;
                   RIL_RadioStateRequest onStateRequest;     
                   RIL_Supports supports;
                   RIL_Cancel onCancel;
                   RIL_GetVersion getVersion;
                  } RIL_RadioFunctions;
  
RIL函数
        ril.h定义了RIL状态和变量,比如RIL_UNSOL_STK_CALL_SETUP, RIL_SIM_READY, RIL_SIM_NOT_READY,具体函数描述见下表。忽略头文件细节。
  
        RIL主动命令请求
        Vendor RIL必须提供下表中的函数用以发送主动命令。RIL主动命令请求类型定义在ril.h的RIL_REQUEST_prefix中。 
        void (*RIL_RequestFunc) (int request, void *data, size_t datalen, RIL_Token t);
        RIL主动命令入口指针,必须能够处理各种RIL主动请求(定义于ril.h的RIL_REQUEST_ prefix)
        * request 是一种 RIL_REQUEST_* 
        * data 是一个指向RIL_REQUEST_*数据的指针 
        * t 应当被用于RIL_onResponse的后续调用
        * datalen 由调用者所有,应当由被调者修改或释放 
        必须调用RIL_onRequestComplete()函数完成通讯。?RIL_onRequestComplete() 在这个函数返回前或之后可能被任意线程调用。这个函数总会调用同一个线程,因此返回到这里意味着无线通讯准备去处理其他命令(无论前面命令是否完成传输)。

        RIL_RadioState (*RIL_RadioStateRequest)();

        这个函数应该返回当前通讯同步状态

        int (*RIL_Supports)(int requestCode);
        如果提供指定RIL_REQUEST代码,返回1,否则返回0.

        void (*RIL_Cancel)(RIL_Token t);
        本函数用来指示取消一个待处理请求。函数将被一个独立线程所调用,而不是RIL_RequestFunc函数。
一旦取消,被调用者应当尽量放弃请求并在这之后调用RIL_onRequestComplete 函数的RIL_Errno CANCELLED 。
响应请求后调用 RIL_onRequestComplete 并产生其他结果是可以被接受的,但会被忽略(理应忽略被取消的请求)。
RIL_Cancel 调用应该被立刻返回,不需要等待取消。

        const char * (*RIL_GetVersion) (void);
        向你的Vendor RIL返回版本字符串 
  
        Vendor RIL使用以下回调函数与Android RIL守护进程通讯。
        void RIL_onRequestComplete(RIL_Token t, RIL_Errno e, void *response, size_t responselen);
        * t 是之前通讯传递至RIL_Notification的参数
        * 如果e != SUCCESS,则可以没有相应,并且被忽略
        * response 由调用者所有,应当由被调用者修改或者释放。 
        * RIL_onRequestComplete 将尽快返回


        void RIL_requestTimedCallback (RIL_TimedCallback callback, void *param, const struct timeval *relativeTime);
        用户指定的回调函数的线程中,RIL_RequestFunc 函数被调用。如果指定了relativeTime,那么回调前将等待一个一个特定的时间值。如果 relativeTime 为空,或者指针指向了一个空的结构体,回调函数会尽快被执行。
  
        RIL被动命令
        下表函数是Vedor RIL使用的回调函数,用来唤醒被动命令在Android平台的相应机制。

        void RIL_onUnsolicitedResponse(int unsolResponse, const void *data, size_t datalen);
        * unsolResponse 是 RIL_UNSOL_RESPONSE_* 其中之一
        * data 是指向RIL_UNSOL_RESPONSE_*数据的指针 
        * data被调用者所有,应当由被调用者修改或者释放        

更多相关文章

  1. C语言函数以及函数的使用
  2. [Android] 基于 Linux 命令行构建 Android 应用(六):Android 应用签
  3. android命令总结

随机推荐

  1. android如何建立数据库。(如何重写SQLiteO
  2. Android中ImageSwitcher结合Gallery展示S
  3. 最新android视频地址及android4.2环境地
  4. Android(安卓)App耗电量统计
  5. Android GC
  6. Ubuntu中 android 安装(JDK+ECLIPSE+ANDRO
  7. Android 用Retrofit进行网络获取数据,recy
  8. Android Audio代码分析12 - stream type
  9. 把ndk作为独立编译器
  10. Android 实现底部菜单栏