学步园

    Android源码目录hardware/ril/libril中总共包含5个C/CPP文件，它们分别是ril_commands.h、ril_unsol_commands.h、ril_event.h、ril_event.cpp和ril.cpp。这篇文章主要分析ril.cpp文件。

    我们可以将该文件划分为定义部分和实现部分，先来看定义部分：

#define LOG_TAG "RILC"</p> <p> #include <hardware_legacy/power.h></p> <p> #include <telephony/ril.h><br /> #include <telephony/ril_cdma_sms.h><br /> #include <cutils/sockets.h><br /> #include <cutils/jstring.h><br /> #include <cutils/record_stream.h><br /> #include <utils/Log.h><br /> #include <utils/SystemClock.h><br /> #include <pthread.h><br /> #include <binder/Parcel.h><br /> #include <cutils/jstring.h></p> <p> #include <sys/types.h><br /> #include <pwd.h></p> <p> #include <stdio.h><br /> #include <stdlib.h><br /> #include <stdarg.h><br /> #include <string.h><br /> #include <unistd.h><br /> #include <fcntl.h><br /> #include <time.h><br /> #include <errno.h><br /> #include <assert.h><br /> #include <ctype.h><br /> #include <alloca.h><br /> #include <sys/un.h><br /> #include <assert.h><br /> #include <netinet/in.h><br /> #include <cutils/properties.h></p> <p> #include <ril_event.h></p> <p> namespace android {</p> <p> #define PHONE_PROCESS "radio"</p> <p> #define SOCKET_NAME_RIL "rild"<br /> #define SOCKET_NAME_RIL_DEBUG "rild-debug"</p> <p> #define ANDROID_WAKE_LOCK_NAME "radio-interface"</p> <p> #define PROPERTY_RIL_IMPL "gsm.version.ril-impl"</p> <p> // match with constant in RIL.java<br /> #define MAX_COMMAND_BYTES (8 * 1024)</p> <p> // Basically: memset buffers that the client library<br /> // shouldn't be using anymore in an attempt to find<br /> // memory usage issues sooner.<br /> #define MEMSET_FREED 1</p> <p> // 常见的获取数组元素个数的方法<br /> #define NUM_ELEMS(a) (sizeof (a) / sizeof (a)[0])</p> <p> // 返回两数中较小者<br /> #define MIN(a,b) ((a)<(b) ? (a) : (b))</p> <p> /* 回复类型：经过请求的回复和未经请求的回复*/<br /> #define RESPONSE_SOLICITED 0<br /> #define RESPONSE_UNSOLICITED 1</p> <p> /* Negative values for private RIL errno's */<br /> #define RIL_ERRNO_INVALID_RESPONSE -1</p> <p> // request, response, and unsolicited msg print macro<br /> // 即打印缓冲区printBuf的大小<br /> #define PRINTBUF_SIZE 8096</p> <p> // Enable RILC log<br /> #define RILC_LOG 0</p> <p> #if RILC_LOG<br /> // 三个宏的调用顺序是startRequest - printRequest - closeRequest<br /> // 这样打印出来的请求命令将包含在（）中<br /> #define startRequest sprintf(printBuf, "(")<br /> #define closeRequest sprintf(printBuf, "%s)", printBuf)<br /> #define printRequest(token, req) \<br /> LOGD("[%04d]> %s %s", token, requestToString(req), printBuf)<br /> // 三个宏的调用顺序是startResponse - printResponse - closeResponse<br /> // 这样打印出来的回复信息将包含在｛｝中<br /> #define startResponse sprintf(printBuf, "%s {", printBuf)<br /> #define closeResponse sprintf(printBuf, "%s}", printBuf)<br /> #define printResponse LOGD("%s", printBuf)</p> <p> #define clearPrintBuf printBuf[0] = 0<br /> #define removeLastChar printBuf[strlen(printBuf)-1] = 0<br /> #define appendPrintBuf(x...) sprintf(printBuf, x)<br /> #else<br /> #define startRequest<br /> #define closeRequest<br /> #define printRequest(token, req)<br /> #define startResponse<br /> #define closeResponse<br /> #define printResponse<br /> #define clearPrintBuf<br /> #define removeLastChar<br /> #define appendPrintBuf(x...)<br /> #endif</p> <p> // 唤醒类型：不唤醒，部分唤醒<br /> enum WakeType {DONT_WAKE, WAKE_PARTIAL};</p> <p> // "经过请求的回复"结构体定义：请求号，命令分发处理函数，返回结果响应函数<br /> // 该结构体的取值见ril_commands.h文件<br /> typedef struct {<br /> int requestNumber;<br /> void (*dispatchFunction) (Parcel &p, struct RequestInfo *pRI);<br /> int(*responseFunction) (Parcel &p, void *response, size_t responselen);<br /> } CommandInfo;</p> <p> //"未经请求的回复"结构体定义：请求号，事件响应函数，唤醒类型<br /> // 该结构体的取值见ril_unsol_commands.h文件<br /> typedef struct {<br /> int requestNumber;<br /> int (*responseFunction) (Parcel &p, void *response, size_t responselen);<br /> WakeType wakeType;<br /> } UnsolResponseInfo;</p> <p> // 请求信息结构体，封装CommandInfo，串成链表<br /> typedef struct RequestInfo {<br /> int32_t token; //this is not RIL_Token<br /> CommandInfo *pCI;<br /> struct RequestInfo *p_next;<br /> char cancelled;<br /> char local; // responses to local commands do not go back to command process<br /> } RequestInfo;</p> <p> // 用户回调信息结构体<br /> typedef struct UserCallbackInfo {<br /> RIL_TimedCallback p_callback; // 回调函数<br /> void *userParam; // 回调函数的参数<br /> struct ril_event event; // ril event<br /> struct UserCallbackInfo *p_next; // 指向下一个回调信息结构（链表形式）<br /> } UserCallbackInfo;</p> <p> /*******************************************************************/<br /> // 初始化回调结构<br /> RIL_RadioFunctions s_callbacks = {0, NULL, NULL, NULL, NULL, NULL};<br /> static int s_registerCalled = 0;</p> <p> static pthread_t s_tid_dispatch; // 分发处理线程ID<br /> static pthread_t s_tid_reader; // 读者线程ID<br /> static int s_started = 0; </p> <p> // 文件描述符初始化<br /> static int s_fdListen = -1;<br /> static int s_fdCommand = -1;<br /> static int s_fdDebug = -1;</p> <p> static int s_fdWakeupRead;<br /> static int s_fdWakeupWrite;</p> <p> // 5个相关的事件<br /> static struct ril_event s_commands_event;<br /> static struct ril_event s_wakeupfd_event;<br /> static struct ril_event s_listen_event;<br /> static struct ril_event s_wake_timeout_event;<br /> static struct ril_event s_debug_event;</p> <p> static const struct timeval TIMEVAL_WAKE_TIMEOUT = {1,0};</p> <p> // 初始化互斥量和条件变量<br /> static pthread_mutex_t s_pendingRequestsMutex = PTHREAD_MUTEX_INITIALIZER;<br /> static pthread_mutex_t s_writeMutex = PTHREAD_MUTEX_INITIALIZER;<br /> static pthread_mutex_t s_startupMutex = PTHREAD_MUTEX_INITIALIZER;<br /> static pthread_cond_t s_startupCond = PTHREAD_COND_INITIALIZER;</p> <p> static pthread_mutex_t s_dispatchMutex = PTHREAD_MUTEX_INITIALIZER;<br /> static pthread_cond_t s_dispatchCond = PTHREAD_COND_INITIALIZER;</p> <p> static RequestInfo *s_pendingRequests = NULL;</p> <p> static RequestInfo *s_toDispatchHead = NULL;<br /> static RequestInfo *s_toDispatchTail = NULL;</p> <p> static UserCallbackInfo *s_last_wake_timeout_info = NULL;</p> <p> static void *s_lastNITZTimeData = NULL;<br /> static size_t s_lastNITZTimeDataSize;</p> <p> #if RILC_LOG<br /> static char printBuf[PRINTBUF_SIZE]; // 缓存打印信息的数组<br /> #endif</p> <p> /*******************************************************************/<br /> // dispatch*系列函数是基带处理器对应用处理器请求的处理函数<br /> static void dispatchVoid (Parcel& p, RequestInfo *pRI);<br /> static void dispatchString (Parcel& p, RequestInfo *pRI);<br /> static void dispatchStrings (Parcel& p, RequestInfo *pRI);<br /> static void dispatchInts (Parcel& p, RequestInfo *pRI);<br /> static void dispatchDial (Parcel& p, RequestInfo *pRI);<br /> static void dispatchSIM_IO (Parcel& p, RequestInfo *pRI);<br /> static void dispatchCallForward(Parcel& p, RequestInfo *pRI);<br /> static void dispatchRaw(Parcel& p, RequestInfo *pRI);<br /> static void dispatchSmsWrite (Parcel &p, RequestInfo *pRI);</p> <p> static void dispatchCdmaSms(Parcel &p, RequestInfo *pRI);<br /> static void dispatchCdmaSmsAck(Parcel &p, RequestInfo *pRI);<br /> static void dispatchGsmBrSmsCnf(Parcel &p, RequestInfo *pRI);<br /> static void dispatchCdmaBrSmsCnf(Parcel &p, RequestInfo *pRI);<br /> static void dispatchRilCdmaSmsWriteArgs(Parcel &p, RequestInfo *pRI);</p> <p> // response*系列函数是应用处理器对基带处理器消息的响应函数<br /> // 包括请求回复响应函数和事件响应函数<br /> static int responseInts(Parcel &p, void *response, size_t responselen);<br /> static int responseStrings(Parcel &p, void *response, size_t responselen);<br /> static int responseString(Parcel &p, void *response, size_t responselen);<br /> static int responseVoid(Parcel &p, void *response, size_t responselen);<br /> static int responseCallList(Parcel &p, void *response, size_t responselen);<br /> static int responseSMS(Parcel &p, void *response, size_t responselen);<br /> static int responseSIM_IO(Parcel &p, void *response, size_t responselen);<br /> static int responseCallForwards(Parcel &p, void *response, size_t responselen);<br /> static int responseDataCallList(Parcel &p, void *response, size_t responselen);<br /> static int responseRaw(Parcel &p, void *response, size_t responselen);<br /> static int responseSsn(Parcel &p, void *response, size_t responselen);<br /> static int responseSimStatus(Parcel &p, void *response, size_t responselen);<br /> static int responseGsmBrSmsCnf(Parcel &p, void *response, size_t responselen);<br /> static int responseCdmaBrSmsCnf(Parcel &p, void *response, size_t responselen);<br /> static int responseCdmaSms(Parcel &p, void *response, size_t responselen);<br /> static int responseCellList(Parcel &p, void *response, size_t responselen);<br /> static int responseCdmaInformationRecords(Parcel &p,void *response, size_t responselen);<br /> static int responseRilSignalStrength(Parcel &p,void *response, size_t responselen);<br /> static int responseCallRing(Parcel &p, void *response, size_t responselen);<br /> static int responseCdmaSignalInfoRecord(Parcel &p,void *response, size_t responselen);<br /> static int responseCdmaCallWaiting(Parcel &p,void *response, size_t responselen);</p> <p> // 将数据结构信息转换成字符串输出<br /> extern "C" const char * requestToString(int request);<br /> extern "C" const char * failCauseToString(RIL_Errno);<br /> extern "C" const char * callStateToString(RIL_CallState);<br /> extern "C" const char * radioStateToString(RIL_RadioState);</p> <p> #ifdef RIL_SHLIB<br /> extern "C" void RIL_onUnsolicitedResponse(int unsolResponse, void *data,<br /> size_t datalen);<br /> #endif</p> <p> static UserCallbackInfo * internalRequestTimedCallback<br /> (RIL_TimedCallback callback, void *param,<br /> const struct timeval *relativeTime);</p> <p> /** Index == requestNumber */<br /> // 很不错的一个用法，由于数组元素太多，为了代码的整洁清晰，<br /> // 将数组元素的定义放在一个单独的头文件中，并用#include进来即可<br /> static CommandInfo s_commands[] = {<br /> #include "ril_commands.h"<br /> };</p> <p> static UnsolResponseInfo s_unsolResponses[] = {<br /> #include "ril_unsol_commands.h"<br /> };

To Be Continued