《OpenHarmony 3GPP协议开发深度剖析》之--PLMN业务源码解读

接续上一篇《OpenHarmony 3GPP协议开发深度剖析》之--搜网流程之PLMN选择
搜网流程可以简单概括为PLMN选择、小区搜索、网络注册，而PLMN选择主要在cp侧完成，而PLMN在OpenHarmony源码中（即AP侧）主要涉及到的业务就是搜网模块中的运营商相关信息获取的业务，比如我们常见的手机状态栏上的运营商名称显示。

下面来针对AP侧中搜网相关的PLMN业务解读下源码流程。

Ril架构回顾

在进行代码解读之前，还是对电话子系统的架构再讲解下，如下图

modem厂商针对OpenHarmony定制自己的lib库，lib库里面主要就是一些AT指令操作，在hril层会根据当前设备的modem指定加载modem对应的厂商库，从而屏蔽直接与modem打交道。而hril层通过HDF驱动框架与tel_ril层进行通信，tel_ril层以上就是AP侧的具体业务逻辑处理了，再往上走就是tel framework层了，该层和tel_ril层主要通过proxy-stub架构进行通信，再framework层就可以定义一些上层api提供给上层应用调用，比如说定义一个api为getOperatorName提供给上层app获取运营商的名称，然后在systemui中调用该api就可以获取到运营商名称并且更新手机状态栏上的运营商名称显示，比如显示“中国移动”。

1.完成Modem初始化，并创建监听modem业务事件监听。

首先从modem侧出发，modem会对电话子系统相关业务事件进行主动上报。

在ril的驱动初始化的时候会加载modem厂商库，见hri_hdf.c中的代码，如下：

struct HdfDriverEntry g_rilAdapterDevEntry = {    .moduleVersion = 1,    .moduleName = "hril_hdf",    .Bind = RilAdapterBind,    .Init = RilAdapterInit,    .Release = RilAdapterRelease,};HDF_INIT(g_rilAdapterDevEntry);static int32_t RilAdapterInit(struct HdfDeviceObject *device){......    LoadVendor();//加载厂商库    return HDF_SUCCESS;}static void LoadVendor(void){......    rilInitOps = (const HRilOps *(*)(const struct HRilReport *))dlsym(g_dlHandle, "RilInitOps");    if (rilInitOps == NULL) { dlclose(g_dlHandle); TELEPHONY_LOGE("RilInit not defined or exported"); return;    }    ops = rilInitOps(&g_reportOps);//初始化modem厂商库    HRilRegOps(ops);    TELEPHONY_LOGI("HRilRegOps completed");}

在LoadVendor中调用了RilInitOps接口，modem厂商库运行的入口在vendor_adapter.c文件中的const HRilOps *RilInitOps(const struct HRilReport * reportOps)接口，代码如下：

const HRilOps *RilInitOps(const struct HRilReport *reportOps){    pthread_attr_t attr;    SetReportOps(reportOps);    pthread_attr_init(&attr);    pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);    int32_t ret = pthread_create(&g_eventListeners, &attr, (void *(*)(void *))EventListeners, NULL);//创建g_eventListeners线程监听modem上报的业务事件    if (ret < 0) { TELEPHONY_LOGE("EventListeners create failed %d \n", ret);    }    if (g_hrilOps.smsOps == NULL) { TELEPHONY_LOGE("g_hrilOps.smsOps is null");    }    TELEPHONY_LOGI("g_hrilOps.smsOps:%{public}p", g_hrilOps.smsOps);    return &g_hrilOps;}

在创建g_eventListeners线程传入的EventListeners里面有如下核心代码：

... if (devicePath != NULL) {  g_fd = open(devicePath, O_RDWR);// 打开设备节点，入参g_devicePath是Modem设备节点 }...int32_t ret = ATStartReadLoop(g_fd, OnNotifyOps);//启动循环，读取处理Modem上报的消息。ModemInit();//modem初始化

ATStartReadLoop的代码如下：

int32_t ATStartReadLoop(int32_t fd, OnNotify func){    int32_t ret = 0;    g_atFd = fd;    g_onNotifyFunc = func;    pthread_attr_t t;    pthread_attr_init(&t);    pthread_attr_setdetachstate(&t, PTHREAD_CREATE_DETACHED);    ret = pthread_create(&g_reader, &t, (void *(*)(void *))ReaderLoop, &t);//创建g_reader线程循环读取处理Modem上报的消息。    if (ret < 0) { TELEPHONY_LOGE("create pthread error code： %{public}d", ret); return VENDOR_ERR_PROCESS;    }    return VENDOR_SUCCESS;}

ModemInit函数的代码如下：

static int32_t ModemInit(void){    ResponseInfo *pResponse = NULL;    int32_t err = SetRadioState(HRIL_RADIO_POWER_STATE_ON, 0);    if (err == -1) { TELEPHONY_LOGE("RadioState set failed");    }    err = SendCommandLock("ATE0Q0V1", NULL, 0, &pResponse);    if (err != 0 || !pResponse->success) { TELEPHONY_LOGE("ATE0Q0V1 send failed");    }    FreeResponseInfo(pResponse);    /* Network registration events */    err = SendCommandLock("AT+CREG=2", NULL, 0, &pResponse);    if (err != 0 || !pResponse->success) { SendCommandLock("AT+CREG=2", NULL, 0, &pResponse);    }    FreeResponseInfo(pResponse);    /* GPRS registration events */    err = SendCommandLock("AT+CGREG=2", NULL, 0, &pResponse);    if (err != 0 || !pResponse->success) { SendCommandLock("AT+CGREG=2", NULL, 0, &pResponse);    }    FreeResponseInfo(pResponse);    /* Enable the extended format of incoming calls */    SendCommandLock("AT+CRC=1", NULL, 0, NULL);    /* Set the SMS service type to Phase 2+ version */    SendCommandLock("AT+CSMS=1", NULL, 0, NULL);    /* Set the new SMS reporting method to +CMTI */    SendCommandLock("AT+CNMI=1,2,0,1,1", NULL, 0, NULL);    /* Enable active reporting of (U)SIM status */    SendCommandLock("AT^SIMST=1", NULL, 0, NULL);    /* Disabled  auto-answer */    SendCommandLock("ATS0=0", NULL, 0, NULL);    /* Extended errors */    SendCommandLock("AT+CMEE=1", NULL, 0, NULL);    /* Set to signal  reporting */    SendCommandLock("AT^HCSQ=3,10", NULL, 0, NULL);    SendCommandLock("AT^CURCEX=2,F7FFFFFFFFFFFF", NULL, 0, NULL);    /* IMS registration events */    SendCommandLock("AT+CIREG=2", NULL, 0, NULL);    /*  Call Waiting notifications */    SendCommandLock("AT+CCWA=1", NULL, 0, NULL);    /* Disabled muted */    SendCommandLock("AT+CMUT=0", NULL, 0, NULL);    /* Enabled CSSU unsolicited supp service notifications */    SendCommandLock("AT+CSSN=0,1", NULL, 0, NULL);    /* Set SMS PDU mode */    SendCommandLock("AT+CMGF=0", NULL, 0, NULL);    /* Set UNICODE character */    SendCommandLock("AT+CSCS=\"IRA\"", NULL, 0, NULL);    /* Set sms memory */    SendCommandLock("AT+CPMS=\"SM\",\"SM\",\"ME\"", NULL, 0, NULL);    /* Set to open network time reporting */    SendCommandLock("AT^TIME=1", NULL, 0, NULL);    /* Set to open network time zone reporting */    SendCommandLock("AT+CTZR=1", NULL, 0, NULL);    /* Enabled SRVCC status to report actively: This command complies with the 3GPP TS 27.007 protocol. */    SendCommandLock("AT+CIREP=1", NULL, 0, NULL);    sleep(SLEEP_TIME);    TELEPHONY_LOGI("enter to : ModemInit OnModemReport %{public}d", g_radioState);    struct ReportInfo reportInfo = {0};    reportInfo.notifyId = HNOTI_MODEM_RADIO_STATE_UPDATED;    reportInfo.type = HRIL_NOTIFICATION;    reportInfo.error = HRIL_ERR_SUCCESS;    OnModemReport(GetSlotId(NULL), reportInfo, (const uint8_t *)&g_radioState, sizeof(HRilRadioState));    return err;}

从代码可以看出，这里初始化就是发出一些列AT指令给modem。

2.modem上报业务事件的回调函数

其中请求参数reportOps为RIL Adapter传入的事件回调函数指针，这个函数回调指针在hri_hdc.c中进行定义，如下：

// 定义Modem厂商库回调函数指针static struct HRilReport g_reportOps = {    OnCallReport,    // 通话相关业务回调函数    OnDataReport,    // 蜂窝数据相关业务回调函数    OnModemReport,   // Modem相关业务回调函数    OnNetworkReport, // 搜网相关业务回调函数    OnSimReport,     // SIM卡相关业务回调函数    OnSmsReport      // 短信相关业务回调函数};

 在hril.h中定义了结构体HRilReport，代码如下：

struct HRilReport {    void (*OnCallReport)(int32_t slotId, struct ReportInfo reportInfo, const uint8_t *data, size_t dataLen);    void (*OnDataReport)(int32_t slotId, struct ReportInfo reportInfo, const uint8_t *data, size_t dataLen);    void (*OnModemReport)(int32_t slotId, struct ReportInfo reportInfo, const uint8_t *data, size_t dataLen);    void (*OnNetworkReport)(int32_t slotId, struct ReportInfo reportInfo, const uint8_t *data, size_t dataLen);    void (*OnSimReport)(int32_t slotId, struct ReportInfo reportInfo, const uint8_t *data, size_t dataLen);    void (*OnSmsReport)(int32_t slotId, struct ReportInfo reportInfo, const uint8_t *data, size_t dataLen);    void (*OnTimerCallback)(HRilCallbackFun func, uint8_t *param, const struct timeval *tv);};

其中OnNetworkReport就是我们要研究的搜网相关业务，而PLMN业务就包含在其中。

在Modem设备节点读取线程g_reader里调用OnNotifyOps()解析具体的Modem上报事件，判断AT命令类型，并调用OnXxxReport()把解析得到的各模块事件上报给hril业务层。

在vendor_report.c中的OnNotifyOps接口代码如下：

void OnNotifyOps(const char *s, const char *smsPdu){    char *str = NULL;    struct ReportInfo reportInfo = {0};    ReportInfoInit(&reportInfo);    if (GetRadioState() == HRIL_RADIO_POWER_STATE_UNAVAILABLE) { return;    }    str = strdup(s);    if (IsCallNoticeCmd(s)) { CallReportInfoProcess(s);    } else if (ReportStrWith(s, "+CMT:")) { HRilSmsResponse smsResponse = {}; smsResponse.pdu = (char *)smsPdu; reportInfo.notifyId = HNOTI_SMS_NEW_SMS; OnSmsReport(GetSlotId(NULL), reportInfo, (const uint8_t *)&smsResponse, strlen(smsResponse.pdu));    } else if (ReportStrWith(s, "+CDS:")) {  ........OnNotifyNetWorksOps(s, str); //上报网络业务事件}

 继续分析OnNotifyNetWorksOps的代码，如下

 reportInfo.error = HRIL_ERR_SUCCESS;    reportInfo.type = HRIL_NOTIFICATION;    if (ReportStrWith(s, "+CREG:")) { OnCsRegStatusNotify(reportInfo, ret, str, s);    } else if (ReportStrWith(s, "+CGREG:")) { OnPsRegStatusNotify(reportInfo, ret, str, s);    } else if (ReportStrWith(s, "^TIME:")) { OnNotifyNetWorksOpsJudgeTwo(reportInfo, infoStr, responseData);    } else if (ReportStrWith(s, "+CTZV:")) {

此时会发现里面也是对AT命令进行判断，比如这个OnCsRegStatusNotify就是CS域注册状态通知，继续看OnCsRegStatusNotify的代码，如下

static void OnCsRegStatusNotify(struct ReportInfo reportInfo, int32_t ret, char *str, const char *s){    reportInfo.notifyId = HNOTI_NETWORK_CS_REG_STATUS_UPDATED;//上报业务事件中的业务标识，这里表示CS域状态更新    HRilRegStatusInfo regStatusInfo;    ret = ProcessRegStatus(str, &regStatusInfo);    if (ret == 0) { OnNetworkReport(GetSlotId(NULL), reportInfo, (const uint8_t *)(&regStatusInfo), sizeof(HRilRegStatusInfo)); //上报网络业务事件    } else { TELEPHONY_LOGW("CREG notify str format  unexpected: %{public}s", s);    }}

从上面代码发现有一个上报事件的业务标识符HNOTI_NETWORK_CS_REG_STATUS_UPDATED。

3. hril层通过HDF框架与tel_rel层

继续去追踪这个标识符的代码，就可以定位到tel_ril层了。

在hril_network.cpp中有如下代码：

void HRilNetwork::AddHandlerToMap(){    // indication    notiMemberFuncMap_[HNOTI_NETWORK_CS_REG_STATUS_UPDATED] = &HRilNetwork::NetworkCsRegStatusUpdated;    notiMemberFuncMap_[HNOTI_NETWORK_SIGNAL_STRENGTH_UPDATED] = &HRilNetwork::SignalStrengthUpdated;    notiMemberFuncMap_[HNOTI_NETWORK_TIME_UPDATED] = &HRilNetwork::NetworkTimeUpdated;    notiMemberFuncMap_[HNOTI_NETWORK_TIME_ZONE_UPDATED] = &HRilNetwork::NetworkTimeZoneUpdated;    ......

这里将HNOTI_NETWORK_CS_REG_STATUS_UPDATED的回调交由HRilNetwork::NetworkCsRegStatusUpdated来处理，下面继续追此代码，如下

int32_t HRilNetwork::NetworkCsRegStatusUpdated(    int32_t indType, const HRilErrNumber e, const void *response, size_t responseLen){    ......    indType = static_cast(ConvertIntToRadioNoticeType(indType));    if (!HdfSbufWriteInt32(dataSbuf, indType)) { TELEPHONY_LOGE("HdfSbufWriteInt32 in NetworkCsRegStatusUpdated is failed!"); HdfSbufRecycle(dataSbuf); return HRIL_ERR_GENERIC_FAILURE;    }    int32_t ret = ServiceNotifyDispatcher(HNOTI_NETWORK_CS_REG_STATUS_UPDATED, dataSbuf);    if (ret != HRIL_ERR_SUCCESS) { TELEPHONY_LOGE("ret is not equal to HRIL_ERR_SUCCESS!"); HdfSbufRecycle(dataSbuf); return HRIL_ERR_GENERIC_FAILURE;    }    if (dataSbuf != nullptr) { HdfSbufRecycle(dataSbuf);    }    return HRIL_ERR_SUCCESS;}

 从上面代码，可以看出通过HDF驱动发送HNOTI_NETWORK_CS_REG_STATUS_UPDATED消息给tel_ril层，下面就可以看tel_rel层与hril_network.cpp所对应的文件tel_ril_network.cpp的代码，有如下关键代码：

void TelRilNetwork::AddHandlerToMap(){    // indication    memberFuncMap_[HNOTI_NETWORK_CS_REG_STATUS_UPDATED] = &TelRilNetwork::NetworkCsRegStatusUpdated;    memberFuncMap_[HNOTI_NETWORK_SIGNAL_STRENGTH_UPDATED] = &TelRilNetwork::SignalStrengthUpdated;    memberFuncMap_[HNOTI_NETWORK_TIME_UPDATED] = &TelRilNetwork::NetworkTimeUpdated;   .....}

这样，上报的cs域状态更新的业务就由NetworkCsRegStatusUpdated函数来处理。

4. 通过观察者模式监听RadioEvent，NetworkSearchHandler进行搜网业务处理

继续阅读上面提到的NetworkCsRegStatusUpdated的代码，如下：

int32_t TelRilNetwork::NetworkCsRegStatusUpdated(MessageParcel &data){    std::shared_ptr regStatusInfo = std::make_shared();    if (regStatusInfo == nullptr) { TELEPHONY_LOGE("regStatusInfo == nullptr"); return TELEPHONY_ERR_LOCAL_PTR_NULL;    }    regStatusInfo->ReadFromParcel(data);    int32_t flagType = data.ReadInt32();    if (observerHandler_ == nullptr) { TELEPHONY_LOGE("observerHandler_ == nullptr"); return TELEPHONY_ERR_LOCAL_PTR_NULL;    } else { TELEPHONY_LOGI("TelRilNetwork::NetworkCsRegStatusUpdated indicationType:%{public}d", flagType); observerHandler_->NotifyObserver(RadioEvent::RADIO_NETWORK_STATE, regStatusInfo); return TELEPHONY_ERR_SUCCESS;    }}

关键代码observerHandler_->NotifyObserver(RadioEvent::RADIO_NETWORK_STATE, regStatusInfo);

这里会使用观察者模式，监听RadioEvent::RADIO_NETWORK_STATE事件。

而对该事件的观察者就是NetworkSearchHandler，下面追踪NetworkSearchHandler的代码，在network_search_handler.cpp中有如下代码

{RadioEvent::RADIO_NETWORK_STATE, &NetworkSearchHandler::GetNetworkStateInfo},

监听到RadioEvent::RADIO_NETWORK_STATE事件，会由GetNetworkStateInfo回调处理，继续追踪GetNetworkStateInfo代码，有如下关键代码：

 case CORE_SERVICE_POWER_OFF:     RadioOffState();     break; case CORE_SERVICE_POWER_ON:     RadioOnState();     break;

 其中RadioOnState函数里面会调用如下代码：

 GetRilOperatorInfo(false);  //获取运营商信息 GetRilPsRegistration(false); GetRilCsRegistration(false);

最终继续去追踪GetRilOperatorInfo这个函数，就会发现可以读取到RIL侧上报过来的PLMN数据，这里就不继续追了。

最后附上上述流程的时序图。

四、业务流程时序图

说说控