一、需求
1、了解IMS相关知识体系
2、RILD 与 RILJ、IMS回调消息的机制
二、相关概念
2.1 IMS
IMS全称是IP Multimedia Subsystem，中文意义为IP多媒体子系统。IMS是一种基于IP基础结构，能够融合数据、话音和移动等网络技术的系统。
IP = 基于IP 的传输，基于IP的会话控制，基于IP的业务实现
Multimedia = 语音、视频、图片、文本等多种媒体组合，在多种接入基础之上具有不同能力的终端组合
Subsvstem = 依赖于现有网络技术和网络设备发展的网络，最大程度重用现有网络系统
（我个人理解IMS是一个很大的概念，它不单单特指:IMS服务、IMS PDN等。它类似GSM，WCDMA，LTE一样，是一种体系结构，包含了好多内容）
2.2 Volte
VoLTE是Voice over LTE的缩写，是基于 IMS 的语音业务。VoLTE基于IP多媒体子系统（IMS）网络，在LTE上使用为控制层面和语音服务的媒体层面特制的配置文件，使语音服务作为数据流在LTE数据承载网络中进行传输，而不再需要维护和依赖传统的电路交换语音网络。通俗的来讲，就是语音通话建立在4G流量之上，无需再依托于2G/3G网，全部承载于4G网络中，最终实现数据与语音业务在同一网络下的统一，使4G网络不再仅仅提供流量数据业务支撑，还提供语音及视频通话支持，让4G网络利用最大化。
移动用户肯定都遇到过这个问题，在玩网络游戏时一则电话打进来，游戏就断网了，这并非手机硬件问题，而是移动4G手机是通过2G信号进行语音通讯，所以通话过程中系统会自动将网络从4G切换到2G。
2.3 CS域与PS域
我们了解到的数据传输有两个域，分别是CS域和PS域。我们常说的CS域就是电路交换域，通常用于语音通话，在2G和3G中都有应用到；我们常说的PS域就是分组交换域，通常用于数据业务，在3G、4G和5G中都有应用到。而还有一个IMS（IP多媒体子系统），相当于是PS域上的一个子系统，IMS的存在可以让用户在PS域上同时使用语音通话和数据业务
2.3.1 CS域
CS（Circuit Switched）域，即电路交换域。首先需要建立一条传输数据的连接，建立完成之后开始数据的传输，此连接不会断开，直到数据传输完毕，才可以释放掉连接。所以一条链路只电路交换的特点是独占一条链路，一直用于数据传输。可靠性很高，但不高效。这就相当于是小时候玩的听筒游戏，两个纸杯子之间连着一条线，两个人通话过程中，这条链路是不能断开的，直到通话结束。
2.3.2 PS域
PS域（Packet Switch）表面意思就是分组交换。PS 域不能直接进行语音业务，PS业务就是常见的数据业务，也包括流媒体业务、VOIP等等。具有高效的传输效率，但可靠性没有CS域那么高。
2.4 VOIP
VOIP是一个很宽泛的概念，VOIP（Voice over IP）的缩写，只要是通过IP传输的语音电话，都可以称为VOIP。如互联网提供商提供（Skype、微信、teams等）、运营商提供的IMS（LTE时代公认的语音解决方案（VoLTE）。因为VoLTE是运营商在LTE层上附着IMS-PDN进行传输的，相对于纯IP网络的skype、微信网络电话，通话质量会好很多。
2.5 URC消息
URC 是Unsolicited Result Code，即"非请求结果码"。 一般的 AT命令 流程都是控制端发出 命令 ，被控端响应结果码。 但当被控端有事件需要通知控制端时，就会主动发出 URC ，例如有呼叫打入、收到新短信息、自动关机等。
2.6 HIDL
HIDL的全称是HAL interface definition language(硬件抽象层接口定义语言) ，是AndroidFramework 与Android HAL之间的接口。HIDL 旨在用于进程间通信(IPC)。Android O(8.0) 之前系统的升级牵扯多方协作，极为麻烦，HIDL机制的推出就是将 framework 与 hal 层分开，使得框架部分可以直接被覆盖、更新，而不需要重新对 HAL 进行编译，这样在系统升级时，OEM 厂商 跳过 SoC厂商，先对 framework 进行升级。
三、环境
- 芯片：高通Qcm2290
- 版本：Android 11
四、设计思路
4.1 RIL结构图
4.2 RIL相关模块介绍
| 模块 | 进程 | 介绍 |
|---|---|---|
| Dialer | com.android.dialer | 负责拨号、呼叫界面显示 |
| TeleService | com.android.phone | 负责通话逻辑，如实际向RIL拨号、挂电话，及电话状态如拨号、振铃、接通等的变更。 |
| TelecomService | system_server | 负责逻辑控制，是沟通各个进程交互的桥梁。 |
| telephony-common（RILJ） | jar，看哪个进程引用，主要是com.android.phone | 主要是phone模块，hal层对应的java层客户端的代码，这个模块的代码就是跟hal下面的C/C++服务进行通信的 |
| RILD | RILD | 主要负责接发RILJ指令、Modem指令 |
| MODEM | Modem | Modem是调制解调器的缩写，它是一种用于数字信号和模拟信号之间转换的设备。在手机中，Modem是一个硬件模块，它负责处理与无线网络通信相关的任务，包括数据传输、语音通信和短信等。 |
4.2.1 Dialer模块
源码： LINUX\android\packages\apps\Dialer
4.2.2 TeleService模块
源码： LINUX\android\packages\services\Telephony
4.2.2.1 TeleService启动
（1）设置persistent标记，此标记AMS会持续保证进程(com.android.phone)存活，意外挂掉也会自动重启。
LINUX\android\packages\services\Telephony/AndroidManifest.xml
<application android:name="PhoneApp"
android:persistent="true"
...
android:directBootAware="true">
（2）SystemServer启动后，ActivityManqgerService服务初始化完成后，启动persistent进程，即Phone模块被启动。
LINUX\android\frameworks\base\services\core\java\com\android\server\am\ActivityManagerService.java
void startPersistentApps(int matchFlags) {
...
synchronized (this) {
try {
final List<ApplicationInfo> apps = AppGlobals.getPackageManager()
.getPersistentApplications(STOCK_PM_FLAGS | matchFlags).getList();
for (ApplicationInfo app : apps) {
if (!"android".equals(app.packageName)) {
addAppLocked(app, null, false, null /* ABI override */,
ZYGOTE_POLICY_FLAG_BATCH_LAUNCH);
}
}
} catch (RemoteException ex) {
}
}
}
4.2.3 TelecomService模块
源码： LINUX\android\packages\services\Telecomm
4.2.3.1 TelecomService启动
Android设备刚开机，SystemServer进程初始化完成启动完系统的核心服务如AMS、PMS后，就会加载系统其它服务，这其中就包含了一个与Telecom服务启动相关的系统服务专门用于加载Telecom：
LINUX\android\frameworks\base\services\java\com\android\server\SystemServer.java
private void run() {
...
startBootstrapServices(t);
startCoreServices(t);
startOtherServices(t);
...
}
private void startOtherServices(@NonNull TimingsTraceAndSlog t)
...
//启动Telecom服务的加载类
t.traceBegin("StartTelecomLoaderService");
mSystemServiceManager.startService(TelecomLoaderService.class);=
t.traceEnd();
//启动telephony注册服务，用于注册监听telephony状态的接口
t.traceBegin("StartTelephonyRegistry");
telephonyRegistry = new TelephonyRegistry(context, new TelephonyRegistry.ConfigurationProvider());
ServiceManager.addService("telephony.registry", telephonyRegistry);
t.traceEnd();
...
//AMS初始化完成，启动Telecom服务
mActivityManagerService.systemReady(() -> {
...
mSystemServiceManager.startBootPhase(t, SystemService.PHASE_ACTIVITY_MANAGER_READY);
...
}, t);
...
}
在TelecomLoaderService类实现Telecom服务的bind工作，完成Telecom的启动
LINUX\android\frameworks\base\services\core\java\com\android\server\telecom\TelecomLoaderService.java
private static final ComponentName SERVICE_COMPONENT = new ComponentName(
"com.android.server.telecom",
"com.android.server.telecom.components.TelecomService");
private static final String SERVICE_ACTION = "com.android.ITelecomService";
@Override
public void onBootPhase(int phase) {
if (phase == PHASE_ACTIVITY_MANAGER_READY) {
...
connectToTelecom();
}
}
//连接Telecom服务
private void connectToTelecom() {
synchronized (mLock) {
...
TelecomServiceConnection serviceConnection = new TelecomServiceConnection();
Intent intent = new Intent(SERVICE_ACTION);
intent.setComponent(SERVICE_COMPONENT);
int flags = Context.BIND_IMPORTANT | Context.BIND_FOREGROUND_SERVICE
| Context.BIND_AUTO_CREATE;
// Bind to Telecom and register the service
if (mContext.bindServiceAsUser(intent, serviceConnection, flags, UserHandle.SYSTEM)) {
mServiceConnection = serviceConnection;
}
}
}
private class TelecomServiceConnection implements ServiceConnection {
@Override
public void onServiceConnected(ComponentName name, IBinder service) {
try {
ITelecomLoader telecomLoader = ITelecomLoader.Stub.asInterface(service);//返回TelecomService代理对象
ITelecomService telecomService = telecomLoader.createTelecomService(mServiceRepo);//返回TelecomService实现类
SmsApplication.getDefaultMmsApplication(mContext, false);
ServiceManager.addService(Context.TELECOM_SERVICE, telecomService.asBinder());//将TelecomService实现类注册到serviceManager，以便后续方便引用
...
}
...
}
4.2.3.2 TeleComService消息处理模型
Telecom是Android的一个系统服务，其主要作用是管理Android系统当前的通话,如来电显示，接听电话，挂断电话等功能，在Telephony模块与上层UI之间起到了一个桥梁的作用。比如，Telephony有接收到新的来电时，首先会告知Telecom,然后由Telecom服务通知上层应用来电信息，并显示来电界面。
4.2.4 telephony-common模块
源码： LINUX\android\frameworks\opt\telephony
telephony-common模块最终编译会生成一个java library，主要是phone模块在引用，hal层对应的java层客户端的代码RILJ，这个模块的代码就是跟hal下面的C/C++服务进行通信的。
LINUX\android\frameworks\opt\telephony\Android.bp
java_library {
name: "telephony-common",
installable: true,
...
}
4.2.5 Telecom_Framewrok模块
源码：LINUX\android\frameworks\base\telecomm
android提供的phone的一些sdk的代码，最终编译完成打包进framework.jar
LINUX\android\frameworks\base\Android.bp
filegroup {
name: "framework-telecomm-sources",
srcs: [
"telecomm/java/**/*.java",
"telecomm/java/**/*.aidl",
],
path: "telecomm/java",
}
framework-telecomm-sources => framework-non-updatable-sources => framework-non-updatable-sources => framework-minus-apex => framework
4.2.6 Telephony_Framewrok模块
源码： LINUX\android\frameworks\base\telephony
android提供的phone的一些sdk的代码，最终编译完成打包进framework.jar
LINUX\android\frameworks\base\Android.bp
filegroup {
name: "framework-telephony-sources",
srcs: [
"telephony/java/**/*.java",
"telephony/java/**/*.aidl",
],
path: "telephony/java",
}
framework-telephony-sources => framework-non-updatable-sources => framework-non-updatable-sources => framework-minus-apex => framework
4.2.7 RIL模块
源码： LINUX\android\hardware\ril
RIL模块由rild守护进程、libril.so、librefrence.so三部分组成：
4.2.7.1 RILD守护进程
源码： LINUX\android\hardware\ril\rild
RILD主要起到承上启下的作用，作为modem和RILJ的通信的中转站。RILD可分为两部分，一是负责与RILJ通讯的部分，主要通过HIDL通信；另一个是负责与modem交互，主要通过AT指令。
4.2.7.1.1 RILD启动
（1）开机时，通过RC文件启动RILD进程
@LINUX\android\hardware\ril\rild\rild.rc
service vendor.ril-daemon /vendor/bin/hw/rild
class main
user radio
disabled
group radio cache inet misc audio log readproc wakelock
capabilities BLOCK_SUSPEND NET_ADMIN NET_RAW
（2）RILD启动后，会执行main啊方法，初始化RILD相关操作
@LINUX\android\hardware\ril\rild\rild.c
int main(int argc, char **argv) {
...
rilInit =
(const RIL_RadioFunctions *(*)(const struct RIL_Env *, int, char **))
dlsym(dlHandle, "RIL_Init");
...
//初始化reference，轮询modem指令
funcs = rilInit(&s_rilEnv, argc, rilArgv);
RLOGD("RIL_Init rilInit completed");
//在rild注册reference的回调函数
RIL_register(funcs);
...
}
4.2.7.2 libril共享库
源码： LINUX\android\hardware\ril\libril
libril.so是共享库，主要负责同上层的通信工作，接收ril的请求，并传递给librefrence_ril.so，同时将librefrence_ril.so返回的消息送给调用进程
4.2.7.3 librefrence共享库
源码： LINUX\android\hardware\ril\reference-ril
librefrence_ril.so是共享库，是由各手机厂商自己实现，在rild进程运行中通过dlopen方式加载，主要负责跟modem硬件通信，转换来自libril的请求为AT命令，同时监听Modem的反馈信息给libril
4.3 RIL相关模块通讯
4.3.1 通讯架构图
五、详细设计
5.1 Dialer拨号
5.1.1 Dialer应用拨号时序图
5.1.2 Dialer拨号界面显示
Dialer应用为拨号提供了界面显示，同时也是拨号请求的触发点
@LINUX\android\packages\apps\Dialer\java\com\android\dialer\dialpadview\DialpadFragment.java
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedState) {
...
View fragmentView = inflater.inflate(R.layout.dialpad_fragment, container, false);//拨号界面布局加载
...
return fragmentView;
}
@Override
public void onClick(View view) {
int resId = view.getId();
if (resId == R.id.dialpad_floating_action_button) {
view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
handleDialButtonPressed();//拨号按钮点击事件
}
...
}
5.1.3 Dialer权限检查
Dialer应用会进行权限检查，判断当前是否为默认拨号盘，且当前应用是否声明CALL_PHONE权限。
public static boolean placeCall(Context context, Intent intent) {
if (hasCallPhonePermission(context)) {//权限检查
getTelecomManager(context).placeCall(intent.getData(), intent.getExtras());
return true;
}
return false;
}
@Deprecated
public static boolean hasCallPhonePermission(Context context) {
return isDefaultDialer(context) || hasPermission(context, Manifest.permission.CALL_PHONE);//判断当前是否为默认拨号盘，且当前应用是否声明CALL_PHONE权限
}
5.1.4 与TelecomService通信
Dialer应用通过TelecomManager对象，将拨号请求消息，通过binder的方式，通知TelecomService进程。
@LINUX\android\frameworks\base\telecomm\java\android\telecom\TelecomManager.java
@RequiresPermission(anyOf = {android.Manifest.permission.CALL_PHONE,
android.Manifest.permission.MANAGE_OWN_CALLS})
public void placeCall(Uri address, Bundle extras) {
ITelecomService service = getTelecomService();//获取服务端代理对象
if (service != null) {
if (address == null) {
Log.w(TAG, "Cannot place call to empty address.");
}
try {
service.placeCall(address, extras == null ? new Bundle() : extras,
mContext.getOpPackageName(), mContext.getAttributionTag());//通过binder实现跨进程通信，将拨号请求发给TelecomService进程
} catch (RemoteException e) {
Log.e(TAG, "Error calling ITelecomService#placeCall", e);
}
}
}
5.2 TelecomService处理拨号流程
5.2.1 TelecomService处理拨号时序图
5.2.2 往InCallService发送请求
（1）startOutgoingCall开始呼叫请求
Dialer进程的拨号请求传递到TelecomService进程后，通过startOutgoingCall方法开始请求打开呼叫界面
@LINUX\android\packages\services\Telecomm\src\com\android\server\telecom\CallIntentProcessor.java
static void processOutgoingCallIntent(
Context context,
CallsManager callsManager,
Intent intent,
String callingPackage,
DefaultDialerCache defaultDialerCache) {
...
// Send to CallsManager to ensure the InCallUI gets kicked off before the broadcast returns
CompletableFuture<Call> callFuture = callsManager
.startOutgoingCall(handle, phoneAccountHandle, clientExtras, initiatingUser,
intent, callingPackage);//开始呼叫请求
final Session logSubsession = Log.createSubsession();
callFuture.thenAccept((call) -> {
if (call != null) {
Log.continueSession(logSubsession, "CIP.sNOCI");
try {
broadcaster.processCall(call, disposition);//发送广播，切换成异步请求
} finally {
Log.endSession();
}
}
});
}
（2）绑定InCallService
InCallServiceImpl是InCallService的子类，在Dialer进程，而TelecomService进程与InCallServiceImpl也是通过bind实现跨进程通信。
@LINUX\android\packages\services\Telecomm\src\com\android\server\telecom\InCallController.java
public static final String SERVICE_INTERFACE = "android.telecom.InCallService";
public int connect(Call call) {
...
Intent intent = new Intent(InCallService.SERVICE_INTERFACE);
intent.setComponent(mInCallServiceInfo.getComponentName());
...
//绑定InCallService类型服务，最终绑定InCallServiceImpl
if (!mContext.bindServiceAsUser(intent, mServiceConnection,
Context.BIND_AUTO_CREATE | Context.BIND_FOREGROUND_SERVICE |
Context.BIND_ALLOW_BACKGROUND_ACTIVITY_STARTS |
Context.BIND_ABOVE_CLIENT,
UserHandle.CURRENT)) {
Log.w(this, "Failed to connect.");
mIsConnected = false;
}
...
}
（3）启动InCallActivity呼叫界面
当InCallServiceImpl被TelecomService进程绑定后，会调用onBind函数，接着启动InCallActivity呼叫界面
@LINUX\android\packages\apps\Dialer\java\com\android\incallui\InCallServiceImpl.java
public IBinder onBind(Intent intent) {
...
InCallPresenter.getInstance().onServiceBind();
InCallPresenter.getInstance().maybeStartRevealAnimation(intent);//开启显示动画
TelecomAdapter.getInstance().setInCallService(this);
...
return iBinder;
}
@LINUX\android\packages\apps\Dialer\java\com\android\incallui\InCallPresenter.java
public void maybeStartRevealAnimation(Intent intent) {
...
//启动InCallActivity呼叫界面
final Intent activityIntent =
InCallActivity.getIntent(context, false, true, false /* forFullScreen */);
activityIntent.putExtra(TouchPointManager.TOUCH_POINT, touchPoint);
context.startActivity(activityIntent);
}
5.2.3 广播下发消息
TelecomService进程发出一个定向广播，由TelecomService进程中的NewOutgoingCallBroadcastIntentReceiver对象接收。
（1）TelecomService进程发送广播
@LINUX\android\packages\services\Telecomm\src\com\android\server\telecom\NewOutgoingCallIntentBroadcaster.java
private void broadcastIntent(
Intent originalCallIntent,
String number,
boolean receiverRequired,
UserHandle targetUser) {
Intent broadcastIntent = new Intent(Intent.ACTION_NEW_OUTGOING_CALL);
...
//发送广播
mContext.sendOrderedBroadcastAsUser(
broadcastIntent,
targetUser,
android.Manifest.permission.PROCESS_OUTGOING_CALLS,
AppOpsManager.OP_PROCESS_OUTGOING_CALLS,
options.toBundle(),
receiverRequired ? new NewOutgoingCallBroadcastIntentReceiver() : null,
null, // scheduler
Activity.RESULT_OK, // initialCode
number, // initialData: initial value for the result data (number to be modified)
null); // initialExtras
}
（2）TelecomService进程接收广播
@LINUX\android\packages\services\Telecomm\src\com\android\server\telecom\NewOutgoingCallIntentBroadcaster.java
public class NewOutgoingCallBroadcastIntentReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
...
placeOutgoingCallImmediately(mCall, resultHandleUri, gatewayInfo,
mIntent.getBooleanExtra(
TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, false),
mIntent.getIntExtra(TelecomManager.EXTRA_START_CALL_WITH_VIDEO_STATE,
VideoProfile.STATE_AUDIO_ONLY));//继续下发呼叫请求
...
}
}
同一个应用中为什么要使用广播来传递消息呢？因为Dialer进程发起拨号请求后，会将消息发给TelecomService进程，通过该进程的placeCall方法层层调用，此时方法是同步调用。直到调用了broadcastIntent，通过广播方式将同步方法转换成异步处理，即当前的呼叫请求下发给TelecomService进程处理，同Dialer进程的呼叫请求结束。
5.2.4 往TeleService下发请求
（1）placeOutgoingCall 下发呼叫请求
接收广播后，通过placeOutgoingCall方法继续下发拨号请求
private void placeOutgoingCallImmediately(Call call, Uri handle, GatewayInfo gatewayInfo,
boolean speakerphoneOn, int videoState) {
...
mCall.setNewOutgoingCallIntentBroadcastIsDone();
mCallsManager.placeOutgoingCall(call, handle, gatewayInfo, speakerphoneOn, videoState);
}
（2）绑定TeleService
binder绑定TeleService服务，实现跨进程通信，同时将将拨号请求分发给TeleService进程，由TeleService进程继续处理
@LINUX\android\packages\services\Telecomm\src\com\android\server\telecom\ConnectionServiceWrapper.java
public void createConnection(final Call call, final CreateConnectionResponse response) {
BindCallback callback = new BindCallback() {
@Override
public void onSuccess() {
...
mServiceInterface.createConnection(...);//与TeleService绑定成功后，发起创建通话连接请求
...
}
@Override
public void onFailure() {
...
}
};
mBinder.bind(callback, call);//绑定TeleService
}
}
@LINUX\android\packages\services\Telecomm\src\com\android\server\telecom\ServiceBinder.java
public static final String SERVICE_INTERFACE = "android.telecom.ConnectionService";
void bind(BindCallback callback, Call call) {
...
if (mServiceConnection == null) {
Intent serviceIntent = new Intent(mServiceAction).setComponent(mComponentName);//该对象为SERVICE_INTERFACE
...
if (mUserHandle != null) {
isBound = mContext.bindServiceAsUser(serviceIntent, connection, bindingFlags,
mUserHandle);//绑定TeleService
}
...
}
}
5.3 TeleService下发拨号请求
5.3.1 TeleService下发拨号请求时序图
5.3.2 TeleService类图
5.3.3 TelephonyConnectionService启动
@LINUX\android\packages\services\Telephony\AndroidManifest.xml
<service
android:singleUser="true"
android:name="com.android.services.telephony.TelephonyConnectionService"
android:label="@string/pstn_connection_service_label"
android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE" >
<intent-filter>
<action android:name="android.telecom.ConnectionService" />
</intent-filter>
</service>
5.3.4 TeleService拨号请求下发（GsmCdmaPhone）
在teleService会获取当前呼叫的phone对象，如GsmCdmaPhone、ImsPhone、SipPhone，来决定要从用哪一种通讯方式进行呼叫。
@LINUX\android\packages\services\Telephony\src\com\android\services\telephony\TelephonyConnectionService.java
public Connection onCreateOutgoingConnection(
PhoneAccountHandle connectionManagerPhoneAccount,
final ConnectionRequest request) {
...
if (PhoneAccount.SCHEME_VOICEMAIL.equals(scheme)) {
// TODO: We don't check for SecurityException here (requires
// CALL_PRIVILEGED permission).
final Phone phone = getPhoneForAccount(request.getAccountHandle(),
false /* isEmergencyCall */, null /* not an emergency call */);//获取Phone对象，决定采用的通讯方式
...
}
...
if (!isEmergencyNumber) {
...
return placeOutgoingConnection(request, resultConnection, phone);//往RILD继续下发消息
}
...
}
5.3.5 TeleService拨号请求下发（ImsPhone）
Android 9 引入了一个名为 ImsService 的新 SystemApi 接口，可以帮助实现IP多媒体子系统。ImsService API 是在 Android 平台与供应商或运营商提供的 IMS 实现之间明确定义的接口。即IMS的具体实现是由供应商或运营商实现。 android提供了相关的系统SystemApi接口。
5.3.5.1 时序图
5.3.5.2 IMS与CDMA、GSM时序切换
与普通的CS通话一致,由Dialer拨号应用,到Telecom,TeleService。区别在于,在GsmCdmaPhone#diale()中，判断是否支持ims通话。
public Connection dial(String dialString, @NonNull DialArgs dialArgs)
throws CallStateException {
...
boolean useImsForCall = useImsForCall(dialArgs)
&& !shallDialOnCircuitSwitch(dialArgs.intentExtras)
&& (isWpsCall ? allowWpsOverIms : true);//是否使用IMS通讯方式
...
if ((useImsForCall && (!isMmiCode || isPotentialUssdCode))
|| (isMmiCode && useImsForUt)
|| useImsForEmergency) {
try {
if (DBG) logd("Trying IMS PS call");
return imsPhone.dial(dialString, dialArgs);//使用IMS通话
} ...
}
...
if (isPhoneTypeGsm()) {
return dialInternal(dialString, new DialArgs.Builder<>()
.setIntentExtras(dialArgs.intentExtras)
.build());//使用GSM通话
} else {
return dialInternal(dialString, dialArgs);//其他通话方式
}
}
5.4 RILD处理拨号请求
5.4.1 RILD拨号请求消息下发时序图
5.4.2 RILJ往RILD发送指令
RILJ往RILD发送指令,请求拨号的消息下发如下：
@LINUX\android\frameworks\opt\telephony\src\java\com\android\internal\telephony\RIL.java
@Override
public void dial(String address, boolean isEmergencyCall, EmergencyNumber emergencyNumberInfo,
boolean hasKnownUserIntentEmergency, int clirMode, UUSInfo uusInfo,
Message result) {
...
IRadio radioProxy = getRadioProxy(result);
if (radioProxy != null) {
RILRequest rr = obtainRequest(RIL_REQUEST_DIAL, result,
mRILDefaultWorkSource);
...
try {
radioProxy.dial(rr.mSerial, dialInfo);//请求拨号
} catch (RemoteException | RuntimeException e) {
handleRadioProxyExceptionForRR(rr, "dial", e);
}
}
}
5.4.3 RILD接收到RILJ指令
RILD接收到RILJ指令，JAVA层与HAL层通过HIDL方式绑定，即HAL也会有对应的dial映射方法。
@LINUX\android\hardware\ril\libril\ril_service.cpp
#define CALL_ONREQUEST(a, b, c, d, e) \
s_vendorFunctions->onRequest((a), (b), (c), (d), ((RIL_SOCKET_ID)(e)))
Return<void> RadioImpl::dial(int32_t serial, const Dial& dialInfo) {
...
CALL_ONREQUEST(RIL_REQUEST_DIAL, &dial, sizeOfDial, pRI, mSlotId);
memsetAndFreeStrings(2, dial.address, uusInfo.uusData);
return Void();
}
5.4.4 RILD和reference侧消息传递
onRequest方法是在哪里被实现的？我们需要关注下s_vendorFunctions是在哪个地方赋值的。关于s_vendorFunctions全局变量，当我们调用reference中的RIL_Init完成初始化时，就会得到reference返回当前链接库提供的接口函数，通过该接口函数我们便可实现rild侧与reference侧的通讯(reference侧也是跑在rild进程，但是考虑到reference一般由modem厂商客制化，不清楚其内部实现，故以下将其称为reference侧，以便更好地区分该模块)。
@LINUX\android\hardware\ril\libril\ril.cpp
extern "C" void
RIL_register (const RIL_RadioFunctions *callbacks) {
...
memcpy(&s_callbacks, callbacks, sizeof (RIL_RadioFunctions));//对象拷贝
...
radio::registerService(&s_callbacks, s_commands);//注册回调函数
...
}
@LINUX\android\hardware\ril\libril\ril_service.cpp
void radio::registerService(RIL_RadioFunctions *callbacks, CommandInfo *commands) {
...
s_vendorFunctions = callbacks;//将回调函数对象赋值，以实现rild侧与reference侧的引用
s_commands = commands;
...
}
5.4.5 reference侧接收到消息
reference层接收到消息， 从onRequest可以看出，reference中对所有的命令请求进行判别，然后选择不同的处理方式。
@LINUX\android\hardware\ril\reference-ril\reference-ril.c
static void onRequest (int request, void *data, size_t datalen, RIL_Token t)
{
...
switch (request) {
...
case RIL_REQUEST_DIAL:
requestDial(data, datalen, t);//拨号请求
break;
case RIL_REQUEST_HANGUP://挂断电话请求
requestHangup(data, datalen, t);
break;
...
}
}
static void requestDial(void *data, size_t datalen __unused, RIL_Token t)
{
...
ret = at_send_command(cmd, NULL);//往modem层发送指令
...
/* success or failure is ignored by the upper layer here.
it will call GET_CURRENT_CALLS and determine success that way */
RIL_onRequestComplete(t, RIL_E_SUCCESS, NULL, 0);
}
5.4.6 reference侧将消息发送至modem侧
reference侧将消息发送至modem侧，at_send_command() -> at_send_command_full() -> at_send_command_full_nolock()，经过上面的操作，就将一条命令通过串口方式传输到了Modem侧。其间，完成了两个重要动作：1、通过writeline发送数据到Modem；2、阻塞当前线程，等待Modem回应。
@LINUX\android\hardware\ril\reference-ril\atchannel.c
static int at_send_command_full_nolock (const char *command, ATCommandType type,
const char *responsePrefix, const char *smspdu,
long long timeoutMsec, ATResponse **pp_outResponse)
{
...
err = writeline (command);//将命令通过AT指令方式写入modem侧
if (err < 0) {
goto error;
}
...
while (sp_response->finalResponse == NULL && s_readerClosed == 0) {
if (timeoutMsec != 0) {
err = pthread_cond_timedwait(&s_commandcond, &s_commandmutex, &ts);//阻塞线程，直到modem侧消息返回
}
...
}
...
return err;
}
5.4.7 modem侧发送消息至reference侧
modem侧发送消息至reference侧，我们需要如何唤醒阻塞的线程呢？当我们发送数据或命令给Modem的时候，阻塞了当前的线程，阻塞的目的就是等待Modem的回应，而如果Modem有数据上来，那么肯定是先被reference的ReaderLoop检测到并处理，因此，也应该是在ReaderLoop的消息处理中去唤醒当前阻塞的线程，而且应该把Modem的反馈传输给阻塞线程。
@LINUX\android\hardware\ril\reference-ril\atchannel.c
static void *readerLoop(void *arg __unused)
{
for (;;) {
...
line = readline();//读取modem返回数据
...
if(isSMSUnsolicited(line)) {
...
} else {
processLine(line);//解析消息
}
}
...
return NULL;
}
static void processLine(const char *line)
{
...
if (sp_response == NULL) {
/* no command pending */
handleUnsolicited(line);//处理URC消息
} else if (isFinalResponseSuccess(line)) {
sp_response->success = 1;
handleFinalResponse(line);//发送回应消息
}
...
}
static void handleFinalResponse(const char *line)
{
sp_response->finalResponse = strdup(line);
pthread_cond_signal(&s_commandcond);//发送一个信号给另外一个正在处于阻塞等待状态的线程,使其脱离阻塞状态
}
5.4.8 reference侧轮询modem指令
reference侧轮询modem指令，ReaderLoop轮询modem消息又是在哪里实现的呢？RILD进程被创建后，会通过RIL_Init初始化相关的reference相关准备工作，其中涉及到打开与modem侧的AT通道，监听modem上报消息。
@LINUX\android\hardware\ril\reference-ril\atchannel.c
const RIL_RadioFunctions *RIL_Init(const struct RIL_Env *env, int argc, char **argv)
{
...
ret = pthread_create(&s_tid_mainloop, &attr, mainLoop, NULL);//创建mainLoop线程
...
}
static void *
mainLoop(void *param __unused)
{
...
for (;;) {
...
ret = at_open(fd, onUnsolicited);//打开AT通道并把处理URC消息的方法onUnsolicited传进去
...
}
}
@LINUX\android\hardware\ril\reference-ril\atchannel.c
int at_open(int fd, ATUnsolHandler h)
{
...
ret = pthread_create(&s_tid_reader, &attr, readerLoop, &attr);//创建readerLooper线程，读取AT指令并处理modem侧消息
...
}
六、RIL指令
6.1 RILJ主动发送指令
源码： android\hardware\ril\libril\ril_commands.h
| 指令 | 功能 |
|---|---|
| RIL_REQUEST_GET_SIM_STATUS | 获取SIM卡状态 |
| RIL_REQUEST_ENTER_SIM_PIN | 请求输入SIM的PIN码（PIN码是用来保护SIM卡安全的密码。PIN码的初始值一般是1234,可以进行更改） |
| RIL_REQUEST_ENTER_SIM_PUK | 请求PUK码和新的PIN码的输入（PUK码是用来解PIN码的解锁码，共8位长） |
| RIL_REQUEST_ENTER_SIM_PIN2 | 请求输入SIM的PIN2码（进入某种特殊功能时，如设置固定号码、设置通话计费等，所要输入的个人识别码） |
| RIL_REQUEST_ENTER_SIM_PUK2 | 请求PUK2码和新的PIN2码的输入（PUK2码就是专门用来为被锁上的PIN2码解锁的） |
| RIL_REQUEST_CHANGE_SIM_PIN | 请求更改PIN码 |
| RIL_REQUEST_CHANGE_SIM_PIN2 | 请求更改PIN2码 |
| RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION | 请求输入网络个人码以便去激活 |
| RIL_REQUEST_GET_CURRENT_CALLS | 请求获取当前呼叫列表 |
| RIL_REQUEST_DIAL | 初始化一个语音呼叫 |
| RIL_REQUEST_GET_IMSI | 取SIM卡中的国际移动用户识别码IMSI(区别移动用户的标志，储存在SIM卡中，可用于区别移动用户的有效信息) |
| RIL_REQUEST_HANGUP | 挂断某一激活的通话 |
| RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND | 挂断所有等待的或者保持的通话 |
| RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND | 释放所有激活的通话并激活保持的或者等待的通话 |
| RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE | 话连接状态的转换，将所有激活的通话转为保持或等待状态（通话状态：IDLE、ACTIVE、HOLDING、WAITING等） |
| RIL__CONFERENCE | 请求加入电话会议 |
| RIL_REQUEST_UDUB | 发送用户确定用户忙UDUB（user determined user busy）信号 |
| RIL_REQUEST_LAST_CALL_FAIL_CAUSE | 请求最近一次通话中断的错误码 |
| RIL_REQUEST_SIGNAL_STRENGTH | 请求当前的信号强度等相关信息 |
| RIL_REQUEST_VOICE_REGISTRATION_STATE | 请求当前注册状态（描述的是信号柱的显示） |
| RIL_REQUEST_DATA_REGISTRATION_STATE | 请求当前注册状态（描述的是3G、4G的显示） |
| RIL_REQUEST_OPERATOR | 请求运营商名称 |
| RIL_REQUEST_RADIO_POWER | 请求打开无线电通讯 |
| RIL_REQUEST_DTMF | 发起DTMF请求（在手机中，常用的DTMF场景是使用手机拨打一些服务台电话，比如客服热线10086、10000之类；电话接入之后，有对应的语音提示输入不同的数字进入不同的菜单，或者要修改资料，对方要验证我们的账号和密码，这时打开手机拨号盘，输入数字信息，对方就知道我们输入的内容是什么。） |
| RIL_REQUEST_SEND_SMS | 发送短信 |
| RIL_REQUEST_SEND_SMS_EXPECT_MORE | 发送短信，且支持串联短信 |
| RIL_REQUEST_SETUP_DATA_CALL | 请求打开数据流量 |
| RIL_REQUEST_SIM_IO | 获取SIM卡号 |
| RIL_REQUEST_SEND_USSD | 请求一个USSD业务（ussd即非结构化补充数据业务，是一种全球移动通信系统 (GSM) 协议，用于发送消息和文本文件。USSD代码一般以*开头，以#结尾，可用于执行一些隐藏功能。） |
| RIL_REQUEST_CANCEL_USSD | 撤销一个USSD业务 |
| RIL_REQUEST_GET_CLIR | 查询当前呼叫号码是否隐藏请求 |
| RIL_REQUEST_SET_CLIR | 设置呼叫号码是否隐藏 |
| RIL_REQUEST_QUERY_CALL_FORWARD_STATUS | 查询呼叫转移的状态 |
| RIL_REQUEST_SET_CALL_FORWARD | 设置呼叫转移 |
| RIL_REQUEST_QUERY_CALL_WAITING | 查询呼叫等待信息 |
| RIL_REQUEST_SET_CALL_WAITING | 设置呼叫等待状态（当移动电话用户正在进行通话时，又有呼叫向您发来。这时发起新呼叫的一方被置于等待，待原通话结束后再将新呼叫接入。） |
| RIL_REQUEST_SMS_ACKNOWLEDGE | 用于短信消息的传送应答 |
| RIL_REQUEST_GET_IMEI | 获取IMEI号 |
| RIL_REQUEST_GET_IMEISV | 获取IMEISV号（MEI有15位，最后一位是Check digit，即检验位；IMEISV有16位，是去掉了Check digit，加上了两位SVN，即software version number。） |
| RIL_REQUEST_ANSWER | 接听电话请求 |
| RIL_REQUEST_DEACTIVATE_DATA_CALL | 断开数据流量业务 |
| RIL_REQUEST_QUERY_FACILITY_LOCK | 查询设备锁定状态 |
| RIL_REQUEST_SET_FACILITY_LOCK | 设置设备锁定状态 |
| RIL_REQUEST_CHANGE_BARRING_PASSWORD | 修改呼叫限制密码 |
| RIL_REQUEST_QUERY_NETWORK_SELECTION_MODE | 查询网络选择 |
| RIL_REQUEST_SET_NETWORK_SELECTION_AUTOMATIC | 设置网络选择为自动 |
| RIL_REQUEST_SET_NETWORK_SELECTION_MANUAL | 设置网络选择为手动 |
| RIL_REQUEST_QUERY_AVAILABLE_NETWORKS | 查询可用网络列表 |
| RIL_REQUEST_DTMF_START | 启动DTMF功能 |
| RIL_REQUEST_DTMF_STOP | 关闭DTMF功能 |
| RIL_REQUEST_BASEBAND_VERSION | 获取基带版本 |
| RIL_REQUEST_SEPARATE_CONNECTION | 将所有激活的呼叫挂起 |
| RIL_REQUEST_SET_MUTE | 设置静音 |
| RIL_REQUEST_ALLOW_DATA | 设置双卡数据切换 |
| RIL_REQUEST_GET_MUTE | 获取静音状态 |
| RIL_REQUEST_QUERY_CLIP | 查询主叫号码（主叫号码识别显示补充业务。CLIP是指被叫移动用户的补充业务,移动用户接收呼叫时,网络向用户提示主叫用户的号码。） |
| RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE | 查询上一次数据连接失败原因 |
| RIL_REQUEST_DATA_CALL_LIST | 查询数据连接信息 |
| RIL_REQUEST_RESET_RADIO | 复位模块 |
| RIL_REQUEST_OEM_HOOK_RAW | ？？？ |
| RIL_REQUEST_OEM_HOOK_STRINGS | ？？？ |
| RIL_REQUEST_SCREEN_STATE | 查询屏幕状态 |
| RIL_REQUEST_SET_SUPP_SVC_NOTIFICATION | 启用/禁用来自网络的补充服务相关通知 |
| RIL_REQUEST_WRITE_SMS_TO_SIM | 复制短信到SIM卡中 |
| RIL_REQUEST_DELETE_SMS_ON_SIM | 删除SIM卡短信 |
| RIL_REQUEST_SET_BAND_MODE | 设置频段模式 |
| RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE | 查询可用频段模式 |
| RIL_REQUEST_STK_GET_PROFILE | 查询STK的配置信息 |
| RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND | 请求打开STK子菜单 |
| RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE | 获取STK子菜单信息 |
| RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM | 接受或拒绝来自SIM卡的呼叫设置请求。 |
| RIL_REQUEST_EXPLICIT_CALL_TRANSFER | 请求呼叫转接业务 |
| RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE | 设置偏好的网络类型 |
| RIL_REQUEST_GET_PREFERRED_NETWORK_TYPE | 获取偏好的网络类型 |
| RIL_REQUEST_GET_NEIGHBORING_CELL_IDS | 获取此设备上的相邻单元列表 |
| RIL_REQUEST_SET_LOCATION_UPDATES | 位置更新 |
| RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE | 请求设置CDMA订阅模式 |
| RIL_REQUEST_CDMA_SET_ROAMING_PREFERENCE | 设置偏好漫游类型 |
| RIL_REQUEST_CDMA_QUERY_ROAMING_PREFERENCE | 查询偏好漫游类型 |
| RIL_REQUEST_SET_TTY_MODE | 设置为聋哑模式 |
| RIL_REQUEST_QUERY_TTY_MODE | 查询聋哑模式状态 |
| RIL_REQUEST_CDMA_SET_PREFERRED_VOICE_PRIVACY_MODE | 设置首选语音隐私(VP) |
| RIL_REQUEST_CDMA_QUERY_PREFERRED_VOICE_PRIVACY_MODE | 获取当前设置的首选语音隐私(VP)模式。 |
| RIL_REQUEST_CDMA_FLASH | ？？？ |
| RIL_REQUEST_CDMA_BURST_DTMF | 发起DTMS请求 |
| RIL_REQUEST_CDMA_VALIDATE_AND_WRITE_AKEY | ？？？ |
| RIL_REQUEST_CDMA_SEND_SMS | CDMA发送短信 |
| RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE | CDMA短信消息的传送应答 |
| RIL_REQUEST_GSM_GET_BROADCAST_SMS_CONFIG | 获取小区广播配置，通过小区广播信道（CBCH）将信息（如地理位置、天气状况等信息）传到手机，再由用户选择接收的一种功能，通过此功能可向用户提供位置信息，天气预报等服务；是向中国移动的手机客户按区域、按频道发送各种实时、动态的分类信息的业务。 |
| RIL_REQUEST_GSM_SET_BROADCAST_SMS_CONFIG | 设置小区广播配置 |
| RIL_REQUEST_GSM_SMS_BROADCAST_ACTIVATION | 小区广播功能开关 |
| RIL_REQUEST_CDMA_GET_BROADCAST_SMS_CONFIG | CDMA获取小区广播配置 |
| RIL_REQUEST_CDMA_SET_BROADCAST_SMS_CONFIG | CDMA设置小区广播配置 |
| RIL_REQUEST_CDMA_SMS_BROADCAST_ACTIVATION | CDMA小区广播开关 |
| RIL_REQUEST_CDMA_SUBSCRIPTION | 查询CDMA的实现模式（CDMA手机两实现模式： 机卡分离式：用户信息写在单独的UIM 卡机卡一体式：用户信息写在手机中的） |
| RIL_REQUEST_CDMA_WRITE_SMS_TO_RUIM | CDMA复制短息到uim卡,RUIM是应用在CDMA2000手机的一种智能卡 |
| RIL_REQUEST_CDMA_DELETE_SMS_ON_RUIM | CDMA删除RUIM卡上短信 |
| RIL_REQUEST_DEVICE_IDENTITY | 请求设备标识 |
| RIL_REQUEST_EXIT_EMERGENCY_CALLBACK_MODE | 离开紧急回拨模式 |
| RIL_REQUEST_GET_SMSC_ADDRESS | 获取SMSC地址，网络短信息服务中心地址 |
| RIL_REQUEST_SET_SMSC_ADDRESS | 设置SMSC地址 |
| RIL_REQUEST_REPORT_SMS_MEMORY_STATUS | 通知modem，SMS的存储情况 |
| RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING | 通知modem，StkService已经启动 |
| RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE | 设置CDMA的实现模式 |
| RIL_REQUEST_ISIM_AUTHENTICATION | ISIM认证 |
| RIL_REQUEST_ACKNOWLEDGE_INCOMING_GSM_SMS_WITH_PDU | 确认收到成功或失败的最后一条传入短信，包括确认TPDU作为RP-ACK或RP-ERROR PDU的RP-User-Data元素发送。 |
| RIL_REQUEST_STK_SEND_ENVELOPE_WITH_STATUS | ？？？ |
| RIL_REQUEST_VOICE_RADIO_TECH | 获取当前的语音无线电技术。 |
| RIL_REQUEST_GET_CELL_INFO_LIST | 获取当前的信元信息 |
| RIL_REQUEST_SET_UNSOL_CELL_INFO_LIST_RATE | 设置信元信息的调用时间，即onCellInfoChanged的响应时间 |
| RIL_REQUEST_SET_INITIAL_ATTACH_APN | 初始化APN |
| RIL_REQUEST_IMS_REGISTRATION_STATE | 查询IMS的注册状态 |
| RIL_REQUEST_IMS_SEND_SMS | 请求IMS发送短信 |
| RIL_REQUEST_SIM_TRANSMIT_APDU_BASIC | 在基本频道上与SIM交换apdu |
| RIL_REQUEST_SIM_OPEN_CHANNEL | 打开SIM无线信道 |
| RIL_REQUEST_SIM_CLOSE_CHANNEL | 关闭SIM无线信道 |
| RIL_REQUEST_SIM_TRANSMIT_APDU_CHANNEL | 在逻辑信道上与SIM交换APDU。 |
| RIL_REQUEST_NV_READ_ITEM | 读取{@link RadioNVItems} / {@code ril_nv_items.h}中定义的NV项之一，用于部分CDMA运营商的设备配置。 |
| RIL_REQUEST_NV_WRITE_ITEM | 写一个定义在{@link RadioNVItems} / {@code ril_nv_items.h}的NV项，用于部分CDMA运营商的设备配置。 |
| RIL_REQUEST_NV_WRITE_CDMA_PRL | 更新无线电NV存储中的CDMA首选漫游列表(PRL)。用于部分CDMA运营商的设备配置。 |
| RIL_REQUEST_NV_RESET_CONFIG | 执行modem配置复位。用于部分CDMA运营商的设备配置。 |
| RIL_REQUEST_SET_UICC_SUBSCRIPTION | ？？？ |
| RIL_REQUEST_ALLOW_DATA | 双卡数据切换 |
| RIL_REQUEST_GET_HARDWARE_CONFIG | 获取RIL的硬件配置 |
| RIL_REQUEST_SIM_AUTHENTICATION | SIM卡身份认证 |
| RIL_REQUEST_GET_DC_RT_INFO | ？？？ |
| RIL_REQUEST_SET_DC_RT_INFO_RATE | ？？？ |
| RIL_REQUEST_SET_DATA_PROFILE | 发送当前运营商的数据配置文件到数据服务进行数据呼叫设置。这是仅适用于CDMA运营商，可通过OTA更改配置文件。数据服务应该总是使用最新的数据配置文件发送的框架。 |
| RIL_REQUEST_SHUTDOWN | 关机 |
| RIL_REQUEST_GET_RADIO_CAPABILITY | 获取电话无线电功能 |
| RIL_REQUEST_SET_RADIO_CAPABILITY | 设置电话无线电类型和接入技术。 |
| RIL_REQUEST_START_LCE | 启动LCE(链路容量估计)服务，并设置所需的报告间隔。 |
| RIL_REQUEST_STOP_LCE | 停止LCE服务。 |
| RIL_REQUEST_PULL_LCEDATA | 获取LCE服务获取容量数据。 |
| RIL_REQUEST_GET_ACTIVITY_INFO | 请求modem的活动信息 |
| RIL_REQUEST_SET_CARRIER_RESTRICTIONS | ？？？ |
| RIL_REQUEST_GET_CARRIER_RESTRICTIONS | ？？？ |
| RIL_REQUEST_SEND_DEVICE_STATE | 发送设备状态到Modem |
| RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER | 打开/关闭调制解调器的主动响应 |
| RIL_REQUEST_SET_SIM_CARD_POWER | 设置SIM卡上电状态。 @param state SIM卡状态(断电、上电、通过) |
| RIL_REQUEST_SET_CARRIER_INFO_IMSI_ENCRYPTION | 设置加密IMSI和IMPI所需的运营商信息。 |
| RIL_REQUEST_START_NETWORK_SCAN | 扫描网络 |
| RIL_REQUEST_STOP_NETWORK_SCAN | 停止扫描网络 |
| RIL_REQUEST_START_KEEPALIVE | 启动长连接 |
| RIL_REQUEST_STOP_KEEPALIVE | 停止长连接 |
6.2 RILJ被动接收指令
源码： android\hardware\ril\libril\ril_unsol_commands.h
| 指令 | 功能 |
|---|---|
| RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED | 无线通信模块状态改变 |
| RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED | 来电状态改变 |
| RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED | 信号状态改变 |
| RIL_UNSOL_RESPONSE_NEW_SMS | 收到短信 |
| RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT | 短信发送状态报告 |
| RIL_UNSOL_RESPONSE_NEW_SMS_ON_SIM | ？？？ |
| RIL_UNSOL_ON_USSD | ？？？ |
| RIL_UNSOL_ON_USSD_REQUEST | ？？？ |
| RIL_UNSOL_NITZ_TIME_RECEIVED | 通知更新终端系统的时间及时区 |
| RIL_UNSOL_DATA_CALL_LIST_CHANGED | 数据连接状态改变 |
| RIL_UNSOL_SUPP_SVC_NOTIFICATION | ？？？ |
| RIL_UNSOL_STK_SESSION_END | 通知会话结束 |
| RIL_UNSOL_STK_PROACTIVE_COMMAND | 插卡开机，Modem检测到有卡插入，这时候Modem会读取SIM中的相关信息，并把消息上报给RIL层，显示STK主菜单 |
| RIL_UNSOL_STK_EVENT_NOTIFY | 用于STK事件分发 |
| RIL_UNSOL_STK_CALL_SETUP | 发送来自modem的拨打电话的主动上报消息 |
| RIL_UNSOL_SIM_SMS_STORAGE_FULL | 通知空间满了 |
| RIL_UNSOL_SIM_REFRESH | modem请求更新卡对应的文件信息 |
| RIL_UNSOL_CALL_RING | 有来电时上报 |
| RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED | SIM卡状态改变 |
| RIL_UNSOL_RESPONSE_CDMA_NEW_SMS | 接收到CDMA短信 |
| RIL_UNSOL_RESPONSE_NEW_BROADCAST_SMS | ？？？ |
| RIL_UNSOL_CDMA_RUIM_SMS_STORAGE_FULL | ？？？ |
| RIL_UNSOL_RESTRICTED_STATE_CHANGED | 受限策略改变通知 |
| RIL_UNSOL_ENTER_EMERGENCY_CALLBACK_MODE | 进入紧急回拨模式通知 |
| RIL_UNSOL_CDMA_CALL_WAITING | 呼叫等待通知 |
| RIL_UNSOL_CDMA_OTA_PROVISION_STATUS | ？？？ |
| RIL_UNSOL_CDMA_INFO_REC | ？？？ |
| RIL_UNSOL_OEM_HOOK_RAW | ？？？ |
| RIL_UNSOL_RINGBACK_TONE | 电话铃声 |
| RIL_UNSOL_RESEND_INCALL_MUTE | ？？？ |
| RIL_UNSOL_CDMA_SUBSCRIPTION_SOURCE_CHANGED | 管理 机卡分离 Or 机卡一体的消息 |
| RIL_UNSOL_CDMA_PRL_CHANGED | 优选漫游列表更新通知 |
| RIL_UNSOL_EXIT_EMERGENCY_CALLBACK_MODE | 离开紧急回拨模式通知 |
| RIL_UNSOL_RIL_CONNECTED | RIL连接成功通知 |
| RIL_UNSOL_VOICE_RADIO_TECH_CHANGED | ？？？ |
| RIL_UNSOL_CELL_INFO_LIST | ？？？ |
| RIL_UNSOL_RESPONSE_IMS_NETWORK_STATE_CHANGED | ？？? |
| RIL_UNSOL_UICC_SUBSCRIPTION_STATUS_CHANGED | ？？？ |
| RIL_UNSOL_SRVCC_STATE_NOTIFY | ？？？ |
| RIL_UNSOL_HARDWARE_CONFIG_CHANGED | ？？？ |
| RIL_UNSOL_DC_RT_INFO_CHANGED | ？？？ |
| RIL_UNSOL_RADIO_CAPABILITY | ？？？ |
| RIL_UNSOL_ON_SS | ？？？ |
| RIL_UNSOL_STK_CC_ALPHA_NOTIFY | ？？？ |
| RIL_UNSOL_LCEDATA_RECV | ？？？ |
| RIL_UNSOL_PCO_DATA | ？？？ |
| RIL_UNSOL_MODEM_RESTART | modem重启通知 |
| RIL_UNSOL_CARRIER_INFO_IMSI_ENCRYPTION | ？？？ |
| RIL_UNSOL_NETWORK_SCAN_RESULT | 通知网络扫描结果 |
| RIL_UNSOL_KEEPALIVE_STATUS | 通知心跳状态 |
七、参考资料
https://source.android.google.cn/docs/core/connect/ims?hl=zh-cn
http://www.taodudu.cc/news/show-3144813.html?action=onClick
http://baike.jld5.cn/news/51009.html
https://wiki.mbalib.com/wiki/IMS
https://blog.csdn.net/guyuewangyue/article/details/122866358
电路交换和分组交换区别：
https://www.elecfans.com/d/1308634.html
TeleComService介绍：
https://blog.csdn.net/qq_40587575/article/details/113753895
TeleService介绍：
https://www.jianshu.com/p/ff51295b84a1
Rild介绍：
https://www.freesion.com/article/21011164222/
https://blog.csdn.net/u014386544/article/details/52594400
RIL指令:
https://www.mianshigee.com/note/detail/23890yjg/
https://blog.csdn.net/iteye_6233/article/details/82230745
https://blog.csdn.net/u010961631/article/details/9446377/
https://blog.csdn.net/sjz4860402/article/details/51182078
http://www.2sim.cn/article/13
https://zhuanlan.zhihu.com/p/117218424
https://blog.csdn.net/u014386544/article/details/56851616