第12章 Reference-RIL运行框架

Reference-RIL完成两部分处理逻辑：

• 与LibRIL交互完成RIL消息的处理。
• 与Modem通信模块交互完成AT命令的执行。

Reference-RIL的运行机制

主要涉及以下几个方面：

• Reference-RIL的初始化函数RIL_Init。
• onRequest函数接收LibRIL的请求调用。
• 接收Modem发出的UnSolicited Response消息的处理逻辑。

RIL_init函数初始化Reference-RIL

RIL_init函数完成的Reference-RIL初始化工作，包括三个操作：

• 记录libRIL提供的RIL_Env指针，通过它可以调用LibRIL提供的相应函数。
• 启动基于mainLoop函数的子线程，mainLoop线程主要负责监听和接收Modem主动上报的UnSolicited消息。
• 返回Reference-RIL提供的指针RIL_RadioFunctions的结构体的针对s_call_backs。

s_callbacks是静态变量，在首次访问reference-ril.cpp时，就会完成其初始化操作。其中包含五个指向函数的指针。
通过函数指针，可以在LibRIL中调用Reference-RIL中定义的函数。

例如：在LibRIL中处理，RILJ中发来的命令形成的ril_event时，会调用s_callbacks.onRequest方法实现与Modem的交互。

onRequest接收LibRIL的请求调用

LibRIL接收到RILJ发来的请求后，
通过s_callbacks.onRequest调用Reference-RIL中的函数，
通过与Modem的交互，处理RIL请求。主要执行两项处理：

• 将RIL请求转化成对应的AT命令，并向Modem发出AT命令。
• 调用LibRIL的RIL_onRequestComplete函数，完成RIL请求处理结果的返回。

在Reference-RIL的onRequest函数中，会根据RIL请求类型调用requestGetCurrentCalls、requestDial、requestHangup等不同函数，完成相应的处理逻辑。
这些函数都完成两件事：

• 向Modem发起执行AT命令的请求。
• 调用RIL_onRequestComplete函数，完成RIL请求的返回。

onRequest函数调用的requestXXX函数共有12个，这些函数中的处理逻辑与大概都是以下的步骤：

• 将请求转化为相关信息组合成的AT命令。
• 调用at_send_command函数，通过AT命令通道向Modem发送AT命令。
• 调用LibRIL提供的函数OnRequestComplete完成RIL请求返回处理结果的回调操作。

UnSolicited消息的处理逻辑

mainLoop函数

在RIL_Init函数中启动了以mainLoop函数为入口函数的子线程。
函数中完成两个关键动作：

• 与Modem建立基于串口的通信连接，同时获取连接的文件的描述符fd；
• 调用at_open函数开启AT命令通道。

at_open函数

at_open函数位于atchannel.c文件中，主要处理逻辑有两点：

• 保存与Modem建立连接的文件描述符fd，接收到Modem发出的AT命令后调用onUnsolicited函数。
• 启动以readerLoop函数为入口的子线程，readerLoop函数循环监听并接收Modem发出的AT命令。

readerLoop函数的处理逻辑可分为两大部分：

• 读取Modem发出的AT命令
• 根据AT命令进行处理。

AT命令的处理分为两个大的分支：

• 短信相关的AT命令的处理
• 普通AT命令的处理

onUnsolicited函数

调用LibRIL提供的RIL_onUnsolicitedResponse函数发出不同类型的UnSolicited Response消息通知。

RIL_onUnsolicitedResponse函数

关键点如下：

• 根据Unsolicited Response消息类型获取s_unsolResponsed数组中对应的UnsolResponseInfo结构体对象，其中包括此消息电源唤醒策略和Parcel数据处理函数。
• 应用UnsolResponseInfo中的电源管理唤醒策略，进行电源唤醒操作。
• 调用UnsolResponseInfo中的Parcel数据处理函数，完成Parcel数据的组织和设置。
• 调用sendRespons 大专栏  第12章 Reference-RIL运行框架e函数，通过Socket连接发送Parcel数据给RILJ。

AT命令

涉及到了如何扩展新 AT 命令，暂时忽略这部分。

Android RIL层运行框架和机制总结

关于RILJ、LibRIL和Reference-RIL的总结：

• RILJ以RIL.java为核心，负责接收Telephony Frameworks发起的Telephony相关查询或控制请求，转换成RIL请求发送给LibRIL进行处理，
  同时，负责接收LibRIL发出的Solicited Response和UnSolicited Response消息，并将消息分发给Telephony Frameworks。
• LibRIL以ril.cpp, ril_event.cpp代码为核心，提供RILC整体运行环境。
  负责接收RILJ发起的RIL请求，将RIL请求转换成对Reference-RIL的onRequest函数的调用，并将RIL请求结果反馈给RILJ。
  同时，还负责接收Reference-RIL发起的Unsolicited相关消息的处理，最终将消息发送给RILJ。
• Reference-RIL以reference-ril.cpp为中心，主要负责与Modem进行AT命令交互；接收LibRIL通过onRequest函数调用，发送来的RIL请求。
  根据请求类型，组合成相应的AT命令交给Modem执行。
  Modem状态有变化时，也会发出AT命令，Reference-RIL会接收并做处理，将主动上报的AT命令转换成Unsolicted消息，发送给LibRIL。

RILJ、LibRIL、Reference-RIL、Modem之间交互的通道：

• RILJ <-> LibRIL ： 名为rild的Socket连接
• LibRIL <-> Reference-RIL ： 直接函数调用
• Reference-RIL <-> Modem ： 串口

总结Solicited消息的处理流程

Solicited消息分为：Solicited Request和Solicited Response，成对出现。
相关要点有：

• RILJ接收到Telephony Framworks发出的请求后，会创建RILRequest对象并保存到mRequestList列表中，
  然后通过Socket向LibRIL发起拨号、挂断电话、交换通话等Telephony控制或查询相关的RIL请求。
• LibRIL通过监听Socket端口并接收RILJ发出的RIL请求，
  经过processCommandsCallback -> processCommandBuffer -> dispatchFunction函数调用，
  最后调用Reference-RIL提供的onRequest函数。
• Reference-RIL中的onRequest函数根据RIL请求类型及相关参数，
  组装AT命令，通过AT命令通道向Modem发起AT命令；
  Modem解析并执行AT命令，在发起AT命令返回结果给Reference-RIL。
• Reference-RIL接收Modem返回的AT命令；
  调用LibRIL提供的onRequestComplete函数，
  将Modem返回的AT命令执行结果返回给LibRIL。
• LibRIL接收到Reference-RIL返回的AT命令执行结果后，通过Socket向RILJ反馈Solicited Response消息，即RIL请求的返回结果。
• RILJ由processSolicited方法处理接收到Solicited Response消息，
  通过RIL请求编号，在mRequestsLlist列表中找到发出RIL请求时对应的RILRequest对象，
  通过它的Message对象发出Handler消息发起回调，Telephony Frameworks全会接收到发起RIL请求的处理结果。

总结Unsolicited消息的处理流程

Unsolicited消息，仅有Response，没有Request。
处理流程中的关键点有：

• Android RIL在手机启动过程中，会启动和加载RIL的运行环境，Reference-RIL会启动子线程调用mainLoop函数监听与Modem间的AT命令通道。
• Modem接收到任何网络通信状态的变化，都会通过AT命令通道发送AT命令给Reference-RIL。
• Reference-RIL接收到Modem发送AT命令后，由onUnsolicited函数将AT命令转换成对应的UnSolicited response消息，
  并调用LibRIL提供的onUnsolicitedResponse方法，向LibRIL发送UnSolicitedResponse消息。
• LibRIL在收到onUnsolicitedResponse函数调用后，通过Socket连接发送Unsolicited Response消息给RILJ。
• RILJ通过RILReceiver监听与LibRIL建立的rild端口的Socket连接，readRilMessage方法读取消息长度。
  根据消息长度读取Socket数据，最后由processResponse方法根据RIL消息类型调用processUnsolicited方法，处理Unsolicited消息。

本章小结

• Reference-RIL的运行机制。
• Reference-RIL与LibRIL进行函数直接调用，完成Solicited和Unsolicited消息的处理。
• Reference-RIL与Modem基于串口的通信完成AT命令的执行。