Android 无线接口层（Radio Layer Interface）



Android 无线接口层（Radio LayerInterface）

 

目录：
1、介绍
2、RIL 初始化
3、RIL 交互
----3.1 主动请求
----3.2  被动请求
4、实现RIL
-----RIL初始化
5、RIL函数
----5.1  RIL 主动命令请求
----5.2  RIL 被动请求的命令

 

1 介绍

Android的无线接口层（RIL）提供了Android电话服务（android.telephony）与无线电硬件之间的抽象层。RIL是通讯无关的，提供基于GSM的网络支持。
    下图显示了RIL位于Android电话系统架构中的位置。图1

实线框表示Android部分，虚线框表示合作伙伴所专用的部分。

 

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

 

2  RIL 初始化

Android在启动时初始化通讯栈和VendorRIL，描述如下：
1. RIL守护进程读取rild.lib路径和rild.libargs系统参数，决定应该使用的VendorRIL库和向Vendor RIL提供的初始化参数

 

2. RIL守护进程加载Vendor RIL库，执行RIL_Init初始化RIL并为RIL函数获取参数。

3. RIL守护进程调用Android通讯栈中RIL_register，为VendorRIL函数提供参考。
    RIL守护进程源码请参考//device/commands/rild/rild.c

 

3  RIL 交互

RIL句柄提供了两种交互方式：

主动请求命令（Solicitedcommands）：主动请求命令来自RIL lib，比如DIAL和HANGUP。

被动请求命令（Unsolicitedresponses）：被动请求命令来自基带，比如CALL_STATE_CHANGED 和 NEW_SMS。

 

3.1 主动请求

以下代码片段属于主动请求命令
　　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系统一个主动请求的电话过程，图2

 

3.2 被动请求

以下代码片段属于被动请求命令：
void OnUnsolicitedResponse (int unsolResponse, void *data, size_t datalen);

 

有超过10条被动请求命令：
* 网络状态改变（4）
* 新短信通知（3）
* 新USSD通知（2）
* 信号强度和时间改变（2）

 

下图表明Android系统中一个被动请求的电话过程：图3

4  实现RIL

为了实现一个通讯专用RIL，需要执行一系列函数以创建一个共享库，保证Android能够响应无线通信请求。所需要的函数被定义在RIL头部（/include/telephony/ril.h）
    Android通讯接口是通讯无关的，VendorRIL可以使用任意协议进行无线通讯。Android提供了一个参考VendorRIL，使用的是贺式（Hayes）AT命令设备，可作为一个商用的快速入门指导以及通讯测试使用。RIL参考源码在/commands/reference-ril/。
    通常将你自己的VendorRIL编译为以下形式：
　　    libril--.so
　　    比如：libril-acme-124.so
　　      其中：
　　         libril：所有vendorRIL的开头；
　　         ：专用公司缩写
　　         ：RIL版本number
　　         so：文件扩展

 

4.1  RIL初始化

特定的VendorRIL必须定义一个初始化函数，提供一系列句柄函数以处理每一个通讯请求。Android RIL守护进程会在启动时调用RIL_Init以初始化RIL。
　　RIL_RadioFunctions *RIL_Init (RIL_Env* env, int argc,char **argv);

 

RIL_Init 返回一个RIL_RadioFunctions结构体包含无线电函数指针。
　　   typestructure {
　　     intRIL_version;
　　     RIL_RequestFunc onRequest;
　　     RIL_RadioStateRequestonStateRequest;     
　　     RIL_Supports supports;
　　     RIL_CancelonCancel;
　　     RIL_GetVersion getVersion;
　　}  

RIL_RadioFunctions;

 

5  RIL函数

ril.h定义了RIL状态和变量，比如RIL_UNSOL_STK_CALL_SETUP,RIL_SIM_READY, RIL_SIM_NOT_READY，具体函数描述见下表。忽略头文件(/device/include/telephony/ril.h)细节。

 

5.1  RIL主动命令请求

VendorRIL必须提供下表中的函数用以发送主动命令。RIL主动命令请求类型定义在ril.h的RIL_REQUEST_prefix中。

 

函数1：

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()在这个函数返回前或之后可能被任意线程调用。这个函数总会调用同一个线程，因此返回到这里意味着无线通讯准备去处理其他命令（无论前面命令是否完成传输）。

 

函数2：

RIL_RadioState(*RIL_RadioStateRequest)( );

 

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

 

函数3：

int(*RIL_Supports)(int requestCode);

描述：

如果提供指定RIL_REQUEST代码，返回1，否则返回0.

 

函数4：

    void(*RIL_Cancel)(RIL_Token t);

描述：

本函数用来指示取消一个待处理请求。函数将被一个独立线程所调用，而不是RIL_RequestFunc函数。

一旦取消，被调用者应当尽量放弃请求并在这之后调用RIL_onRequestComplete函数的RIL_Errno CANCELLED 。

响应请求后调用RIL_onRequestComplete 并产生其他结果是可以被接受的，但会被忽略(理应忽略被取消的请求)。

RIL_Cancel 调用应该被立刻返回，不需要等待取消。

 

函数5： constchar * (*RIL_GetVersion) (void);

描述：向你的Vendor RIL返回版本字符串

 

 

Vendor RIL使用以下回调函数与Android RIL守护进程通讯。

 

函数1：

void RIL_onRequestComplete(RIL_Token t, RIL_Errno e, void *response,size_t responselen);

 

描述：

*  t 是之前通讯传递至RIL_Notification的参数
*  如果e !=SUCCESS，则可以没有相应，并且被忽略
*  response 由调用者所有，应当由被调用者修改或者释放。
*  RIL_onRequestComplete 将尽快返回

 

函数2：

voidRIL_requestTimedCallback (RIL_TimedCallback callback, void *param, const structtimeval *relativeTime);

 

描述：

用户指定的回调函数的线程中，RIL_RequestFunc函数被调用。如果指定了relativeTime，那么回调前将等待一个一个特定的时间值。如果relativeTime 为空，或者指针指向了一个空的结构体，回调函数会尽快被执行。

 

5.2  RIL被动命令

下表函数是Vedor RIL使用的回调函数，用来唤醒被动命令在Android平台的相应机制。具体细节看ril.h

 

函数：

void RIL_onUnsolicitedResponse(int unsolResponse, const void *data,size_t datalen);

 

描述：

* unsolResponse 是RIL_UNSOL_RESPONSE_* 其中之一
* data 是指向RIL_UNSOL_RESPONSE_*数据的指针
* data被调用者所有，应当由被调用者修改或者释放

 

 

 

 

 

 

 

 

 

 

reference-ril.c文件存放路径：

wangk@debian:~/JWT/Android-JWT/hardware/ril/reference-ril$

 

 

所在目录结构：/hardware/ril/ 

|-- ril     （无线电抽象层）
|   |-- include    （头文件）
|   |-- libril    （库）
|   |-- reference-cdma-sms （cdma短信参考）
|   |-- reference-ril    （ril参考）
|   |-- rild     （ril后台服务程序）

 

 

 Radio Interface Layer (RIL)和UI框架结构

     RIL介绍

     背景知识介绍，AT命令和ppp

     RIL的工作原理和涉及的系统服务

     RIL的电话呼叫过程和ppp激活过程UI的surface框架

 

【Android RIL 开发】

目标: 熟悉android ril架构，能够开发简单的ril模块，实现打电话发短信的功能
内容:
      1、Android RIL 系统架构分析
      2、Android RIL 参考实现分析
      3、针对硬件平台实现简单的RIL模块

实验
      根据参考实现，实现android ril模块，实现打电话发短信功能

把电话切换到CDMA，ril正常，现在framework层用的是GSM

 

 

 

 

3G共有三个国际标准,分别是美国主导的CDMA2000，和欧洲主导的WCDMA、中国提出的第三代移动通信标准(简称3G)TD-SCDMA。