OpenHarmony 電話子系統源碼解析之Cellular_Data
一、電話子系統概述
電話服務子系統各個模塊主要作用如下：
核心服務模塊：主要功能是初始化RIL管理、SIM卡和搜網模塊。
數據服務模塊：主要功能是實現數據上網和路由管理相關的業務。
通話管理模塊：主要功能是管理CS(Circuit Switch，電路交換)、IMS(IP Multimedia Subsystem，IP多媒體子系統)和OTT(over the top，OTT解決方案)三種類型的通話，申請通話所需要的音視頻資源，處理多路通話時產生的各種沖突。
蜂窩通話模塊：主要功能是實現基于運營商網絡的基礎通話。
短彩信模塊：主要功能是短信收發和彩信編解碼。
狀態注冊模塊：主要功能是提供電話服務子系統各種消息事件的訂閱以及取消訂閱的API。
1、 電話子系統框架圖
二、 Cellular_Data(數據服務模塊)
1、 代碼目錄
\base\telephony\ cellular_data
├─ frameworks # napi接口存放目錄
├─ interfaces # 對外部暴露的接口
├─ services # 服務內部代碼
│ ├─ apn_manager # apn管理
│ ├─ state_machine # data 狀態機
│ ├─ utils # 通用邏輯
│ └─ 外部files
├─ sa_profile # sa文件
├─ ohos.build # 編譯build
└─ test # 測試相關
2、 流程圖
APP調用數據業務的流程會依次經過Data Service，Core Service，RIL Adapter/RILD，再經過AT命令的處理到達CP處理器。
CP處理器處理完數據命令后，會依次將結果再返回，到達Data Service，最終將獲得的上網相關數據，如ip,interface,gateway,dns等設置到netmanager/netd，最終配置到kernel中。
流程圖如下：
3、data service初始化流程
Data service的初始化流程如下圖所示：
具體的代碼調用流程如下：
\telephony\cellular_data\services\src\cellular_data_service.cpp
在OnStart函數中先等待CoreService啟動成功WaitCoreServiceToInit，然后進行data service的init初始化流程。
在初始化init流程中,會依次進行InitModule的初始化，主要是生成CellularDataController和netd相關的對象的初始化.
\telephony\cellular_data\services\src\cellular_data_controller.cpp
在AsynchronousRegister函數中，會依次進行CellularDataController的初始化、注冊監聽事件、注冊database監聽。還有要進行CellularDataHandler的初始化。
注冊的監聽事件包括了網絡狀態的監聽、radio狀態的監聽和電話狀態的監聽等，這些都會對數據的狀態產生影響。
\telephony\cellular_data\services\src\cellular_data_handler.cpp
CellularDataHandler的Init函數中，主要是對apn管理相關的模塊進行初始化，包含ApnManager和ApnHolder等。
\telephony\cellular_data\services\src\apn_manager\ apn_manager.cpp
\telephony\cellular_data\services\src\apn_manager\ apn_holder.cpp.cpp
\telephony\cellular_data\services\src\apn_manager\ apn_item.cpp
apn_manager負責對所有apn進行管理，包括創建、查找和刪除等操作。
apn_holder就是一個apn profile。
4、data service建立流程
Data service的建立流程如下圖所示：
具體的代碼調用流程如下：
\telephony\core_service\interfaces\innerkits\cellular_data\
cellular_data_manager.cpp
\telephony\core_service\interfaces\innerkits\cellular_data\
cellular_data_service.cpp
\telephony\core_service\interfaces\innerkits\cellular_data\
cellular_data_controller.cpp
\telephony\core_service\interfaces\innerkits\cellular_data\
cellular_data_handler.cpp
按照上面的時序圖可以看出，從cellular_data_manager->cellular_data_service-> cellular_data_controller->cellular_data_handler，是直接調用Enable CellularData。主要的流程在cellular_data_handler中，具體說明EstablishDataConnection過程中比較重要的流程，其中包含了data狀態機的創建EstablishDataConnection和connect event的發送：
\telephony\cellular_data\services\src\state_machine\ cellular_data_state_machine.cpp:
創建default data所需要的狀態機，類似的，任何類型的數據，應該都會創建其所對應的狀態機：
std::shared_ptr<CellularDataStateMachine> CellularDataHandler::CreateCellularDataConnect()
{
auto cellularDataStateMachine =
std::make_shared<CellularDataStateMachine>(connectionManager_, shared_from_this(), GetEventRunner());
if (cellularDataStateMachine == nullptr) {
TELEPHONY_LOGE("cellularDataStateMachine is null");
return nullptr;
}
sequence_++;
intStateMachineMap_[sequence_] = cellularDataStateMachine;
return cellularDataStateMachine;
}
接下來會進行data狀態機的init初始化操作，會依次創建Active、Inactive等狀態到狀態機中，并設置初始狀態為Active，為后續的data connect做好準備：
void CellularDataStateMachine::Init()
{
activeState_ = std::make_unique<Active>(
std::weak_ptr<CellularDataStateMachine>(shared_from_this()), "Active").release();
inActiveState_ = std::make_unique<Inactive>(
std::weak_ptr<CellularDataStateMachine>(shared_from_this()), "Inactive").release();
activatingState_ = std::make_unique<Activating>(
std::weak_ptr<CellularDataStateMachine>(shared_from_this()), "Activating").release();
disconnectingState_ = std::make_unique<Disconnecting>(
std::weak_ptr<CellularDataStateMachine>(shared_from_this()), "Disconnecting").release();
defaultState_ = std::make_unique<Default>(
std::weak_ptr<CellularDataStateMachine>(shared_from_this()), "Default").release();
netProviderInfo_ = std::make_unique<NetProviderInfo>().release();
netLinkInfo_ = std::make_unique<NetLinkInfo>().release();
if (activeState_ == nullptr || inActiveState_ == nullptr || activatingState_ == nullptr ||
disconnectingState_ == nullptr || defaultState_ == nullptr || netProviderInfo_ == nullptr ||
netLinkInfo_ == nullptr) {
TELEPHONY_LOGE("memory allocation failed");
return;
}
activeState_->SetParentState(defaultState_);
inActiveState_->SetParentState(defaultState_);
activatingState_->SetParentState(defaultState_);
disconnectingState_->SetParentState(defaultState_);
StateMachine::SetOriginalState(inActiveState_);
StateMachine::Start();
}
在上面狀態機創建的過程中，最后會建立數據請求：
這個流程會按照狀態機當前的狀態來執行,會先走到inactive狀態中，執行真正的DoConnect，并轉換狀態到Activating。
最終是通過狀態機的DoConnect來建立數據的：
\telephony\cellular_data\services\src\state_machine\ cellular_data_state_machine.cpp:
接下來就會將建立數據的請求發送給core,最終發送給ril_adapter，完成數據建立的流程。
