Android无线接口层RIL

　　

RIL 交互&＃xff1a;
        RIL句柄提供了两种交互方式&＃xff1a;
        主动请求命令&＃xff08;Solicited commands&＃xff09;&＃xff1a;主动请求命令来自RIL lib&＃xff0c;比如DIAL和HANGUP。
        被动请求命令&＃xff08;Unsolicited responses&＃xff09;&＃xff1a;被动请求命令来自基带&＃xff0c;比如CALL_STATE_CHANGED 和 NEW_SMS。
　　
主动请求&＃xff1a;
        以下代码片段属于主动请求命令
　　 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个主动请求命令&＃xff1a;
        * SIM PIN&＃xff0c;IO和IMSI/IMEI&＃xff08;11&＃xff09;
        * 电话状态和动作&＃xff08;拨号&＃xff0c;应答&＃xff0c;静音…&＃xff09;&＃xff08;16&＃xff09;
        * 网络状态查询&＃xff08;4&＃xff09;
        * 网络设置&＃xff08;禁止&＃xff0c;转发&＃xff0c;选择…&＃xff09;&＃xff08;12&＃xff09;
        * 短信&＃xff08;3&＃xff09;
        * PDP连接&＃xff08;4&＃xff09;
        * 电源和复位&＃xff08;2&＃xff09;
        * 辅助服务&＃xff08;5&＃xff09;
        * 供应商定义及其支持&＃xff08;4&＃xff09;
　　
        下图表明了Android系统一个主动请求的电话过程&＃xff1a;

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

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

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

        libril&＃xff1a;所有vendor RIL的开头&＃xff1b;
　　 &＃xff1a;专用公司缩写
　　 &＃xff1a;RIL版本number
　　 so&＃xff1a;文件扩展
　　
RIL初始化&＃xff1a;
        特定的Vendor RIL必须定义一个初始化函数&＃xff0c;提供一系列句柄函数以处理每一个通讯请求。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函数&＃xff1a;
        ril.h定义了RIL状态和变量&＃xff0c;比如RIL_UNSOL_STK_CALL_SETUP, RIL_SIM_READY, RIL_SIM_NOT_READY&＃xff0c;具体函数描述见下表。忽略头文件细节。
　　
        RIL主动命令请求
        Vendor RIL必须提供下表中的函数用以发送主动命令。RIL主动命令请求类型定义在ril.h的RIL_REQUEST_prefix中。　
        void (*RIL_RequestFunc) (int request, void *data, size_t datalen, RIL_Token t);
        RIL主动命令入口指针&＃xff0c;必须能够处理各种RIL主动请求&＃xff08;定义于ril.h的RIL_REQUEST_ prefix&＃xff09;
        * request 是一种 RIL_REQUEST_* 
        * data 是一个指向RIL_REQUEST_*数据的指针 
        * t 应当被用于RIL_onResponse的后续调用
        * datalen 由调用者所有&＃xff0c;应当由被调者修改或释放 
        必须调用RIL_onRequestComplete()函数完成通讯。?RIL_onRequestComplete() 在这个函数返回前或之后可能被任意线程调用。这个函数总会调用同一个线程&＃xff0c;因此返回到这里意味着无线通讯准备去处理其他命令&＃xff08;无论前面命令是否完成传输&＃xff09;。

        RIL_RadioState (*RIL_RadioStateRequest)();

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

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

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

        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 !&＃61; SUCCESS&＃xff0c;则可以没有相应&＃xff0c;并且被忽略
        * response 由调用者所有&＃xff0c;应当由被调用者修改或者释放。 
        * RIL_onRequestComplete 将尽快返回